DataGrid.RowValidationErrorTemplate Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Ruft die Vorlage ab, die für die visuelle Darstellung eines Fehlers bei der Zeilenüberprüfung verwendet wird, oder legt diese fest.

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

ControlTemplate

Die Vorlage, mit der ein Fehler in der Zeilenvalidierung visuell dargestellt wird. Der registrierte Standardwert ist null. Weitere Informationen zu Einflüssen auf diesen Wert finden Sie unter DependencyProperty.

Beispiele

Im folgenden Beispiel wird das standardmäßige Zeilenvalidierungsfeedback durch einen besser sichtbaren Indikator ersetzt. Wenn ein Benutzer einen ungültigen Wert eingibt, erscheint in der Zeilenüberschrift ein roter Kreis mit einem weißen Ausrufezeichen. Die zugehörige Fehlermeldung wird in einer QuickInfo angezeigt. Dieses Codebeispiel ist Teil eines größeren Beispiels für das Thema Vorgehensweise: Implementieren der Validierung mit dem DataGrid-Steuerelement .

<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 sowohl auf Zellenebene als auch auf Zeilenebene Validierungen durchführen. Mit der Validierung auf Zellebene überprüfen Sie einzelne Eigenschaften eines gebundenen Datenobjekts, wenn ein Benutzer einen Wert ändert. Mit der Validierung auf Zeilenebene überprüfen Sie ganze Datenobjekte, wenn ein Benutzer Änderungen an einer Zeile anwendet. Sie können benutzerdefiniertes visuelles Feedback für Validierungsfehler auf Zeilenebene bereitstellen, indem Sie eine ControlTemplate angeben, die die Darstellung des Fehlerindikators definiert. Legen Sie die RowValidationErrorTemplate -Eigenschaft auf fest null , um den Standardfehlerindikator zu verwenden.

Gilt für:

Weitere Informationen