IValueProvider.SetValue(String) Yöntem

Tanım

Ad Alanı:

System.Windows.Automation.Provider

Bütünleştirilmiş Kod:

UIAutomationProvider.dll

Denetimin değerini ayarlar.

public:
 void SetValue(System::String ^ value);

public void SetValue (string value);

abstract member SetValue : string -> unit

Public Sub SetValue (value As String)

Parametreler

value

String

Ayarlanacak değer. Sağlayıcı, değeri uygun veri türüne dönüştürmekle sorumludur.

Özel durumlar

InvalidOperationException

Yerel ayara özgü bilgiler yanlış biçimlendirilmiş bir tarih gibi yanlış biçimde bir denetime geçirilirse.

ArgumentException

Yeni bir değer bir dizeden denetimin tanıdığı biçime dönüştürülemiyorsa.

ElementNotEnabledException

Etkinleştirilmemiş bir denetimi işleme girişiminde bulunulduğunda.

Örnekler

Aşağıdaki örnek kod, değerinin sınırlı uzunlukta bir dizeye ayarlanmasını sağlayan özel bir denetimi gösterir.

/// <summary>
/// Sets the value of the control.
/// </summary>
/// <param name="value">
/// The new value.
/// </param>
void IValueProvider.SetValue(string value)
{
    if (((IValueProvider)this).IsReadOnly)
        throw new InvalidOperationException(
            "Operation cannot be performed.");
    // Arbitrary string length limit.
    if (value.Length > 5)
        throw new ArgumentOutOfRangeException(
            "String is greater than five characters in length.");
    controlValue = value;
}

''' <summary>
''' Sets the value of the control.
''' </summary>
''' <param name="value">
''' The new value.
''' </param>
Private Sub SetValue(ByVal value As String) Implements IValueProvider.SetValue
    If (CType(Me, IValueProvider)).IsReadOnly Then
        Throw New InvalidOperationException("Operation cannot be performed.")
    End If
    ' Arbitrary string length limit.
    If value.Length > 5 Then
        Throw New ArgumentOutOfRangeException("String is greater than five characters in length.")
    End If
    controlValue = value
End Sub

Açıklamalar

Tek satırlı düzenleme denetimleri, uygulayarak IValueProvideriçeriklerine program aracılığıyla erişimi destekler. Ancak, çok satırlı düzenleme denetimleri uygulanmaz IValueProvider; bunun yerine uygulayarak ITextProvideriçeriklerine erişim sağlarlar.

ve gibi denetimler, denetimin geçerli düzenleme modundan bağımsız olarak ListItemTreeItem öğelerden herhangi birinin değeri düzenlenebilirse uygulanmalıdır IValueProvider . Alt öğeler düzenlenebilirse üst denetimin de uygulanması IValueProvider gerekir.

Düzenlenebilir Liste Öğesi Örneği