DataGrid.RowValidationErrorTemplate Eigenschaft

Definition

Ruft die Vorlage ab, die für die visuelle Darstellung eines Fehlers bei der Zeilenüberprüfung verwendet wird, oder legt diese fest.Gets or sets the template that is used to visually indicate an error in row validation.

public:
 property System::Windows::Controls::ControlTemplate ^ RowValidationErrorTemplate { System::Windows::Controls::ControlTemplate ^ get(); void set(System::Windows::Controls::ControlTemplate ^ value); };
public System.Windows.Controls.ControlTemplate RowValidationErrorTemplate { get; set; }
member this.RowValidationErrorTemplate : System.Windows.Controls.ControlTemplate with get, set
Public Property RowValidationErrorTemplate As ControlTemplate

Eigenschaftswert

Die Vorlage, mit der ein Fehler in der Zeilenvalidierung visuell dargestellt wird.The template that is used to visually indicate an error in row validation. Der registrierte Standardwert ist null.The registered default is null. Weitere Informationen zu Einflüssen auf diesen Wert finden Sie unter DependencyProperty.For more information about what can influence the value, see DependencyProperty.

Beispiele

Im folgenden Beispiel wird das standardmäßige Zeilen Validierungs Feedback durch einen besser sichtbaren Indikator ersetzt.The following example replaces the default row validation feedback with a more visible indicator. Wenn ein Benutzer einen ungültigen Wert eingibt, wird ein roter Kreis mit einem weißen Ausrufezeichen im Zeilen Header angezeigt.When a user enters an invalid value, a red circle with a white exclamation mark appears in the row header. Die zugehörige Fehlermeldung wird in einer QuickInfo angezeigt.The associated error message is displayed in a ToolTip. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für das Thema Gewusst wie: Implementieren der Validierung mit dem DataGrid-Steuer Element bereitgestellt wird.This code example is part of a larger example provided for the How to: Implement Validation with the DataGrid Control topic.

<DataGrid.RowValidationErrorTemplate>
  <ControlTemplate>
    <Grid Margin="0,-2,0,-2"
      ToolTip="{Binding RelativeSource={RelativeSource
      FindAncestor, AncestorType={x:Type DataGridRow}},
      Path=(Validation.Errors)[0].ErrorContent}">
      <Ellipse StrokeThickness="0" Fill="Red" 
        Width="{TemplateBinding FontSize}" 
        Height="{TemplateBinding FontSize}" />
      <TextBlock Text="!" FontSize="{TemplateBinding FontSize}" 
        FontWeight="Bold" Foreground="White" 
        HorizontalAlignment="Center"  />
    </Grid>
  </ControlTemplate>
</DataGrid.RowValidationErrorTemplate>

Hinweise

Mit dem DataGrid-Steuerelement können Sie die Überprüfung sowohl auf Zellen-als auch auf Zeilenebene durchführen.The DataGrid control enables you to perform validation at both the cell and row level. Bei der Überprüfung auf Zellen Ebene überprüfen Sie einzelne Eigenschaften eines gebundenen Datenobjekts, wenn ein Benutzer einen Wert aktualisiert.With cell-level validation, you validate individual properties of a bound data object when a user updates a value. Bei der Validierung auf Zeilenebene überprüfen Sie die gesamten Datenobjekte, wenn ein Benutzer Änderungen an einer Zeile ausführt.With row-level validation, you validate entire data objects when a user commits changes to a row. Sie können ein angepasstes visuelles Feedback für Validierungs Fehler auf Zeilenebene bereitstellen, indem Sie eine ControlTemplate angeben, die die Darstellung des Fehler Indikators definiert.You can provide customized visual feedback for row-level validation errors by specifying a ControlTemplate that defines the appearance of the error indicator. Legen Sie die RowValidationErrorTemplate-Eigenschaft auf null fest, um den Standardfehler Indikator zu verwenden.Set the RowValidationErrorTemplate property to null to use the default error indicator.

Gilt für:

Siehe auch