RichEdit

Die Komponente RichEdit ist ein Rich-Text-Editor für mehrzeilige Textspalten von Dataverse. Sie bietet die Formatierung, die der eigene Rich-Text-Editor von Dynamics bietet – Schriftarten und Größen, Farben, Listen, Einzüge, Ausrichtung, Links, Bilder und Tabellen – und schreibt sie so, wie Dynamics es schreibt, sodass ein Dokument, das in Ihrem Portal und in einer modellgesteuerten App bearbeitet wurde, in beiden gleich aussieht. Es wird mit den eigenen Steuerungen von Fluent UI gezeichnet und folgt Ihrem Thema.

React

Blazor

Rich-Text-Spalten

Eine Spalte, deren Format in Dataverse Rich Text ist, benötigt nichts Zusätzliches: ColumnEdit Sie rendert ein RichEdit für sie, wobei ihr Label, Längenbegrenzung, erforderliches Level und Berechtigungen wie jeder andere Editor aus der Spalte übernommen werden.

React

Blazor

Jede mehrzeilige Textspalte

Verwenden RichEdit Sie es direkt, um jede andere mehrzeilige Textspalte als Rich Text zu bearbeiten. Ihr Wert ist dann das HTML des Dokuments. Raster und Exporte zeigen den Text einer solchen Spalte ohne Formatierung.

React

Blazor

Bilder

Bilder können aus der Symbolleiste eingefügt, eingefügt oder weggelassen werden. Sie werden gespeichert, während Dynamics sie speichert, in msdyn_richtextfile Datensätzen, wenn der Benutzer diese erstellen und lesen kann – gewähren Sie ihnen in Ihrer Tabelle Berechtigungen. Ohne diese Berechtigung wird ein Bild direkt im Dokument gespeichert. Stellen Sie AllowImages auf false Einstellung, um Bilder auszuschalten.

React

Blazor

Verdichtete Werkzeugleiste

Für einen Editor mit wenig Spielraum oder für kurze Texte wie eine Notiz eingestellt ToolbarMode Condensed: Die Symbolleiste zeigt dann nur die am häufigsten verwendete Formatierung an – rückgängig machen und wiederholen, fett, kursiv, unterstreichen, durchstreichen, hervorheben und Textfarben, aufzählige und nummerierte Listen sowie Links – und einen Button am Ende, der die Anzeige zu allen anderen Buttons öffnet und wieder schließt. Benennen Sie andere Buttons mit CondensedToolbarButtons (React: condensedToolbarButtons), einer Liste von RichEditToolbarButton Werten: Die Symbolleiste zeigt diese in der Reihenfolge an, in der die vollständige Werkzeugleiste sie zeichnet. Beschränken Sie die Werkzeugleiste selbst, vollständig oder verdichtet, auf die in (React: ) genannten ToolbarButtons Buttons (React: toolbarButtons); sie begrenzt die Buttons, nicht die Formatierung, sodass Tastenkombinationen und eingefügter Text weiterhin formatiert werden. Stellen Sie auf false so ein, DisplayToolbar dass gar keine Symbolleiste angezeigt wird.

React

Blazor

React

Blazor

React

Blazor

Thema

Der Rand, die Symbolleiste und der Fokusindikator des Editors verwenden die Design-Tokens von Fluent UI, sodass sie die anderen Editoren in hellen und dunklen Themen sowie mit deiner Akzentfarbe übereinstimmen. Die eigene Formatierung eines Dokuments – seine Schriftarten und Farben – wird wie geschrieben dargestellt, wie Dynamics es anzeigt.

Beispiel

Eine Bindung an eine Rich-Text-Spalte RichEdit , geöffnet auf einem Beispieldokument.

React-Beispiel

Blazor-Beispiel

React TypeScript

Razor

Reichhaltige Beschreibung

Konfigurationsoptionen

Nutzen Sie die untenstehenden Steuerungen, um die verfügbaren Immobilien zu erkunden.

React-Beispiel

Blazor-Beispiel

React TypeScript

Razor

Nur lesen?

Erforderlich?

Behindert?

Werkzeugleiste?

Werkzeugleisten-Buttons

Rückgängig machen

Erneutes Verfahren

Kopierformatierung

Taufbecken

Schriftgröße

Kühn

Kursiv

Unterstreichung

Durchstreichen

Lichterfarbe

Textfarbe

Aufzählungsliste

Nummerierte Liste

Verringerungseinzug

Einzug erhöhen

Blockzitat

Links ausrichten

Ausrichtungszentrum

Rechts ausrichten

Link

Link entfernen

Index

Spitzenschrift

Bild einfügen

Von links nach rechts

Rechts nach links

Formatierung entfernen

Tabelle einfügen

Verdichtete Werkzeugleiste?

Bilder?

Autofit-Höhe?

Reihen

Reichhaltige Beschreibung

Reagieren

Blazor

RichEdit Baureihe

Parameter

Name	Typ	Default	Beschreibung
`AllowImages`	bool	True	Ob Bilder eingefügt werden können – aus der Werkzeugleiste, eingefügt oder weggelassen werden. Standardeinstellungen auf `true`.
`AutoFitHeight`	bool	False	Ob der Schnittbereich zu seinem Inhalt passt – von einer Zeile bis , `RichEdit.Rows`dann Scrollen – statt immer Linien hoch zu sein `RichEdit.Rows` . Standardmäßig steht auf `false`.
`ChildContent`	RenderFragment?		Kindinhalt der Komponente
`ColumnName`*	string		Spaltenlogischer Name, um den Editor aus dem Tabelleneintrag zu binden.
`CondensedToolbarButtons`	IReadOnlyCollection<RichEditToolbarButton>?		Die Schaltflächen einer verdichteten Werkzeugleiste zeigen (`RichEditToolbarMode.Condensed`), eingezeichnet in die Reihenfolge, in der die vollständige Werkzeugleiste sie zeichnet, egal in welcher Reihenfolge sie benannt sind; der Button am Ende Öffnet es immer noch zum Rest von `RichEdit.ToolbarButtons`. Nicht fest oder leer, die Formatierung, die am häufigsten verwendet wird (`RichEdit.DefaultCondensedToolbarButtons`): rückgängig machen und neu machen, fett, Kursiv, Unterstreichen, Durchstreichen, hervorheben und Textfarben, Stichpunkt- und Nummerierungslisten sowie Links.
`Description`	string?		Beschreibung wird im Tooltip angezeigt.
`Disabled`	bool?		Sollte der Editor deaktiviert werden?
`DisplayLabelWhenAvailable`	bool	True	Gibt an, ob eine Etikette angezeigt werden soll, falls verfügbar.
`DisplayToolbar`	bool	True	Ob die Formatierungsleiste angezeigt wird. Standardmäßig steht .`true`
`DisplayTooltipWhenAvailable`	bool	True	Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.
`DisplayValidationErrorMessage`	bool	True	Sollte eine Fehlermeldung zur Validierung angezeigt werden, wenn die Komponente die Validierung nicht besteht?
`IsVisible`	bool	True	Ist der Editor sichtbar?
`Label`	string?		Text soll als Etikett für den Editor angezeigt werden.
`LabelPosition`	EditorLabelPosition?		Wo das Etikett relativ zur Steuerung liegt. Wenn `null` (der Standard) die Editor nimmt die Position auf der nächstgelegenen umschließenden SectionColumn, Section oder PageLayout, und `EditorLabelPosition.Auto` wenn keiner eines setzt.
`MaxLength`	int?		Maximale Länge des gespeicherten Wertes, inklusive Formatierung: Was die Spalte enthält. Gelöst aus den Metadaten der Spalte, wenn sie nicht gesetzt ist.
`MinLength`	int?		Die Mindestanzahl der Textzeichen – der Text, nicht die Formatierung.
`Placeholder`	string?		Im Editor angezeigt, während er leer ist.
`ReadOnly`	bool?		Sollte der Editor nur lesegeschützt sein?
`Required`	bool?		Sollte der Wert erforderlich sein.
`Rows`	int	10	Höhe des Bearbeitungsbereichs in Textzeilen, je nachdem, wie viel das Dokument füllt; länger Inhalt scrollt. Mit `RichEdit.AutoFitHeight`, wächst es maximal an. Standardmäßig steht 10.
`ToolbarButtons`	IReadOnlyCollection<RichEditToolbarButton>?		Die einzigen Buttons, die die Symbolleiste anzeigt, vollständig oder gekürzt, sind in der Reihenfolge der vollständigen Werkzeugleiste gezeichnet zeichnet sie. Eine verdichtete Werkzeugleiste zeigt diejenigen an `RichEdit.CondensedToolbarButtons` , die sind hier, und öffnet sich zu den anderen; da keiner mehr angezeigt wird, gibt es keinen Knopf zum Öffnen raus. Es schränkt die Buttons ein, nicht die Formatierung: Tastenkürzel und eingefügter Text bleiben Format. Nicht festgelegt oder leer, jeder Button wird angezeigt.
`ToolbarMode`	RichEditToolbarMode	Full	Wie viel von der Symbolleiste wird angezeigt: jeder Button oder die Formatierung, die am häufigsten mit einem Button verwendet wird. Das zeigt den Rest (`RichEditToolbarMode.Condensed`). Standardmäßig gilt `RichEditToolbarMode.Full`.
`Value`	string?		Erhält oder setzt den Wert des Editors: das HTML der Spalte.

Name: AllowImages

Typ: bool

Default: True

Beschreibung: Ob Bilder eingefügt werden können – aus der Werkzeugleiste, eingefügt oder weggelassen werden. Standardeinstellungen auf true.

Name: AutoFitHeight

Typ: bool

Default: False

Beschreibung: Ob der Schnittbereich zu seinem Inhalt passt – von einer Zeile bis , RichEdit.Rowsdann Scrollen – statt immer Linien hoch zu sein RichEdit.Rows . Standardmäßig steht auf false.

Name: ChildContent

Typ: RenderFragment?

Beschreibung: Kindinhalt der Komponente

Name: ColumnName*

Typ: string

Beschreibung: Spaltenlogischer Name, um den Editor aus dem Tabelleneintrag zu binden.

Name: CondensedToolbarButtons

Typ: IReadOnlyCollection<RichEditToolbarButton>?

Beschreibung: Die Schaltflächen einer verdichteten Werkzeugleiste zeigen (RichEditToolbarMode.Condensed), eingezeichnet in die Reihenfolge, in der die vollständige Werkzeugleiste sie zeichnet, egal in welcher Reihenfolge sie benannt sind; der Button am Ende Öffnet es immer noch zum Rest von RichEdit.ToolbarButtons. Nicht fest oder leer, die Formatierung, die am häufigsten verwendet wird (RichEdit.DefaultCondensedToolbarButtons): rückgängig machen und neu machen, fett, Kursiv, Unterstreichen, Durchstreichen, hervorheben und Textfarben, Stichpunkt- und Nummerierungslisten sowie Links.

Name: Description

Typ: string?

Beschreibung: Beschreibung wird im Tooltip angezeigt.

Name: Disabled

Typ: bool?

Beschreibung: Sollte der Editor deaktiviert werden?

Name: DisplayLabelWhenAvailable

Typ: bool

Default: True

Beschreibung: Gibt an, ob eine Etikette angezeigt werden soll, falls verfügbar.

Name: DisplayToolbar

Typ: bool

Default: True

Beschreibung: Ob die Formatierungsleiste angezeigt wird. Standardmäßig steht .true

Name: DisplayTooltipWhenAvailable

Typ: bool

Default: True

Beschreibung: Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.

Name: DisplayValidationErrorMessage

Typ: bool

Default: True

Beschreibung: Sollte eine Fehlermeldung zur Validierung angezeigt werden, wenn die Komponente die Validierung nicht besteht?

Name: IsVisible

Typ: bool

Default: True

Beschreibung: Ist der Editor sichtbar?

Name: Label

Typ: string?

Beschreibung: Text soll als Etikett für den Editor angezeigt werden.

Name: LabelPosition

Typ: EditorLabelPosition?

Beschreibung: Wo das Etikett relativ zur Steuerung liegt. Wenn null (der Standard) die Editor nimmt die Position auf der nächstgelegenen umschließenden SectionColumn, Section oder PageLayout, und EditorLabelPosition.Auto wenn keiner eines setzt.

Name: MaxLength

Typ: int?

Beschreibung: Maximale Länge des gespeicherten Wertes, inklusive Formatierung: Was die Spalte enthält. Gelöst aus den Metadaten der Spalte, wenn sie nicht gesetzt ist.

Name: MinLength

Typ: int?

Beschreibung: Die Mindestanzahl der Textzeichen – der Text, nicht die Formatierung.

Name: Placeholder

Typ: string?

Beschreibung: Im Editor angezeigt, während er leer ist.

Name: ReadOnly

Typ: bool?

Beschreibung: Sollte der Editor nur lesegeschützt sein?

Name: Required

Typ: bool?

Beschreibung: Sollte der Wert erforderlich sein.

Name: Rows

Typ: int

Default: 10

Beschreibung: Höhe des Bearbeitungsbereichs in Textzeilen, je nachdem, wie viel das Dokument füllt; länger Inhalt scrollt. Mit RichEdit.AutoFitHeight, wächst es maximal an. Standardmäßig steht 10.

Name: ToolbarButtons

Typ: IReadOnlyCollection<RichEditToolbarButton>?

Beschreibung: Die einzigen Buttons, die die Symbolleiste anzeigt, vollständig oder gekürzt, sind in der Reihenfolge der vollständigen Werkzeugleiste gezeichnet zeichnet sie. Eine verdichtete Werkzeugleiste zeigt diejenigen an RichEdit.CondensedToolbarButtons , die sind hier, und öffnet sich zu den anderen; da keiner mehr angezeigt wird, gibt es keinen Knopf zum Öffnen raus. Es schränkt die Buttons ein, nicht die Formatierung: Tastenkürzel und eingefügter Text bleiben Format. Nicht festgelegt oder leer, jeder Button wird angezeigt.

Name: ToolbarMode

Typ: RichEditToolbarMode

Default: Full

Beschreibung: Wie viel von der Symbolleiste wird angezeigt: jeder Button oder die Formatierung, die am häufigsten mit einem Button verwendet wird. Das zeigt den Rest (RichEditToolbarMode.Condensed). Standardmäßig gilt RichEditToolbarMode.Full.

Name: Value

Typ: string?

Beschreibung: Erhält oder setzt den Wert des Editors: das HTML der Spalte.

Veranstaltungen

Name	Typ	Beschreibung
`ValueChanged`	EventCallback<ColumnValueBase>	Erhält oder setzt einen Callback, der den gebundenen Wert aktualisiert.

Name: ValueChanged

Typ: EventCallback<ColumnValueBase>

Beschreibung: Erhält oder setzt einen Callback, der den gebundenen Wert aktualisiert.

Methoden

Name	Parameter	Typ	Beschreibung
`FocusAsync`		Task	Setzt den Cursor in den Editor.
`GetValidationErrors`		List<string>	Gibt Validierungsfehler für den aktuellen Wert zurück: Das Minimum zählt den Text, das Maximum Zählt, was gespeichert wird.
`OnImageError`	string fileName string reason	void	JS → C#: Ein vom Benutzer gewähltes Bild konnte nicht eingefügt werden. Stand unter dem Editor.
`OnStateChanged`	JsonElement state	void	JS → C#: Was die Symbolleiste anzeigt, hat sich geändert – die Auswahl wurde verschoben oder die Formatierung verändert.
`OnValueChanged`	string value	Task	JS → C#: Das Dokument hat sich geändert. Trägt den Wert zum Speicheren oder null, wenn es leer ist.
`UploadImageAsync`	IJSStreamReference image string fileName long size	Task<string>	JS → C#: Speichert ein vom Benutzer eingefügtes Bild als msdyn_richtextfile Datensatz und gibt es zurück es ist ID – oder `null` wenn der Benutzer keine erstellt oder zurückliest, und die Das Bild wird stattdessen im Dokument behalten.

Name: FocusAsync

Typ: Task

Beschreibung: Setzt den Cursor in den Editor.

Name: GetValidationErrors

Typ: List<string>

Beschreibung: Gibt Validierungsfehler für den aktuellen Wert zurück: Das Minimum zählt den Text, das Maximum Zählt, was gespeichert wird.

Name: OnImageError

Parameter: string fileName
string reason

Typ: void

Beschreibung: JS → C#: Ein vom Benutzer gewähltes Bild konnte nicht eingefügt werden. Stand unter dem Editor.

Name: OnStateChanged

Parameter: JsonElement state

Typ: void

Beschreibung: JS → C#: Was die Symbolleiste anzeigt, hat sich geändert – die Auswahl wurde verschoben oder die Formatierung verändert.

Name: OnValueChanged

Parameter: string value

Typ: Task

Beschreibung: JS → C#: Das Dokument hat sich geändert. Trägt den Wert zum Speicheren oder null, wenn es leer ist.

Name: UploadImageAsync

Parameter: IJSStreamReference image
string fileName
long size

Typ: Task<string>

Beschreibung: JS → C#: Speichert ein vom Benutzer eingefügtes Bild als msdyn_richtextfile Datensatz und gibt es zurück es ist ID – oder null wenn der Benutzer keine erstellt oder zurückliest, und die Das Bild wird stattdessen im Dokument behalten.