IValueProvider.SetValue(String) Yöntem

Tanım

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

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

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

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.
Düzenlenebilir Liste Öğesi Örneği

Şunlara uygulanır