Freigeben über


NamedRange.Validation-Eigenschaft

Ruft ein Validation-Objekt ab, das die Datenvalidierung für das NamedRange-Steuerelement darstellt.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Validation As Validation
Validation Validation { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Excel.Validation
Ein Validation-Objekt, das die Datenvalidierung für das NamedRange-Steuerelement darstellt.

Hinweise

Zum Hinzufügen einer Validierung zu einem benannten Bereich muss der Startereignishandler verwendet werden.Weitere Informationen zum Startereignishandler finden Sie unter Ereignisse in Office-Projekten.

Beispiele

Im folgenden Beispiel wird mithilfe der Validation-Eigenschaft überprüft, ob in einen NamedRange eine Zeichenfolge mit mindestens drei Zeichen eingegeben wurde.Die SetValidation-Methode muss vom Startereignishandler aufgerufen werden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    Private Sub SetValidation()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Validation.Add( _
            Excel.XlDVType.xlValidateTextLength, _
            Excel.XlDVAlertStyle.xlValidAlertStop, _
            Excel.XlFormatConditionOperator.xlGreater, 3, )

        namedRange1.Validation.InputMessage = "Enter a name."
        namedRange1.Validation.ErrorMessage = _
            "Please enter a name with 3 or more characters."
    End Sub

private void SetValidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    namedRange1.Validation.Add(
        Excel.XlDVType.xlValidateTextLength,
        Excel.XlDVAlertStyle.xlValidAlertStop,
        Excel.XlFormatConditionOperator.xlGreater, 3);

    namedRange1.Validation.InputMessage = "Enter a name.";
    namedRange1.Validation.ErrorMessage =
        "Please enter a name with 3 or more characters.";
}

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace