IValueProvider.SetValue(String) Methode

Definitie

Naamruimte:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll

Hiermee stelt u de waarde van een besturingselement in.

public:
 void SetValue(System::String ^ value);
public void SetValue(string value);
abstract member SetValue : string -> unit
Public Sub SetValue (value As String)

Parameters

value
String

De waarde om in te stellen. De provider is verantwoordelijk voor het converteren van de waarde naar het juiste gegevenstype.

Uitzonderingen

InvalidOperationException

Als landinstellingenspecifieke informatie wordt doorgegeven aan een besturingselement in een onjuiste indeling, zoals een onjuist opgemaakte datum.

ArgumentException

Als een nieuwe waarde niet kan worden geconverteerd van een tekenreeks naar een indeling die door het besturingselement wordt herkend.

ElementNotEnabledException

Wanneer een poging wordt gedaan om een besturingselement te bewerken dat niet is ingeschakeld.

Voorbeelden

In de volgende voorbeeldcode ziet u een aangepast besturingselement waarmee de waarde kan worden ingesteld op een tekenreeks met een beperkte lengte.

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

Opmerkingen

Besturingselementen voor bewerkingen met één regel bieden ondersteuning voor programmatische toegang tot hun inhoud door te implementeren IValueProvider. Besturingselementen voor bewerken met meerdere regels implementeren echter niet IValueProvider; in plaats daarvan bieden ze toegang tot hun inhoud door ITextProvider te implementeren.

Besturingselementen zoals ListItem en TreeItem moeten worden geïmplementeerd IValueProvider als de waarde van een van de items kan worden bewerkt, ongeacht de huidige bewerkingsmodus van het besturingselement. Het bovenliggende besturingselement moet ook worden geïmplementeerd IValueProvider als de onderliggende items kunnen worden bewerkt.

Bewerkbaar lijstitem.

Van toepassing op