NamedRange.Validation-Eigenschaft

Artikel
08/10/2011

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
    Get

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", missing],
        "namedRange1");

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

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via