_XDocument3.GetDataVariable-Methode

Článek
04/27/2010

Ruft den Wert der angegebenen Variablen ab. Dabei handelt es sich um eine vordefinierte Variable, die als Verarbeitungsanweisungsattribut in dem einem Formular zugrunde liegenden XML-Dokument gespeichert ist.

Diese Methode ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(22)> _
Function GetDataVariable ( _
    lVariableNumber As Integer _
) As String
'Usage
Dim instance As _XDocument3
Dim lVariableNumber As Integer
Dim returnValue As String

returnValue = instance.GetDataVariable(lVariableNumber)

[DispIdAttribute(22)] 
string GetDataVariable (
    int lVariableNumber
)

Parameter

lVariableNumber
Die Nummer der Variablen.

Rückgabewert

Der Wert der angegebenen Variablen. Dabei handelt es sich um eine vordefinierte Variable, die als Verarbeitungsanweisungsattribut in dem einem Formular zugrunde liegenden XML-Dokument gespeichert ist.

Hinweise

Wenn die Variable nicht definiert oder leer ist, gibt die GetDataVariable-Methode eine leere Zeichenfolge zurück. Um eine Variable festzulegen, verwenden Sie die SetDataVariable-Methode.

Hinweis:
Von InfoPath wird nur die Verwendung der initialView-Variablen unterstützt. Dabei handelt es sich um die Variable zur Festlegung der Anfangsansicht, die beim Öffnen eines Formulars angezeigt wird. Die Nummer der Variablen ist immer "1", und ihr Wert muss dem Namen einer Ansicht im Formular entsprechen.

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Beispiel

Im folgenden Beispiel wird die GetDataVariable-Methode des XDocument-Objekts verwendet, um den Wert der ersten Variablen zurückzugeben:

string variable1;
variable1= thisXDocument.GetDataVariable(1);

Siehe auch

Referenz

_XDocument3-Schnittstelle
_XDocument3-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím