IValueProvider.SetValue(String) Metoda

Definice

Obor názvů:

System.Windows.Automation.Provider

Sestavení:

UIAutomationProvider.dll

Nastaví hodnotu ovládacího prvku.

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

public void SetValue (string value);

abstract member SetValue : string -> unit

Public Sub SetValue (value As String)

Parametry

value

String

Hodnota k nastavení. Zprostředkovatel zodpovídá za převod hodnoty na příslušný datový typ.

Výjimky

InvalidOperationException

Pokud jsou informace specifické pro národní prostředí předány ovládacímu prvku v nesprávném formátu, jako je například nesprávně formátované datum.

ArgumentException

Pokud nelze převést novou hodnotu z řetězce na formát, ovládací prvek rozpozná.

ElementNotEnabledException

Při pokusu o manipulaci s ovládacím prvku, který není povolen.

Příklady

Následující příklad kódu ukazuje vlastní ovládací prvek, který umožňuje jeho hodnotu nastavit na řetězec omezené délky.

/// <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

Poznámky

Jednořádkové ovládací prvky pro úpravy podporují programový přístup k jejich obsahu implementací IValueProvider. Víceřádkové ovládací prvky pro úpravy však neimplementují IValueProvider. Místo toho poskytují přístup ke svému obsahu implementací ITextProvider.

Ovládací prvky jako ListItem a TreeItem musí být implementovány IValueProvider , pokud je možné upravit hodnotu některé z položek bez ohledu na aktuální režim úprav ovládacího prvku. Nadřazený ovládací prvek musí také implementovat IValueProvider , pokud je možné upravit podřízené položky.

Příklad upravitelné položky seznamu