XPathTypedValue-Klasse
Implementiert das von bestimmten Eigenschaftswerten der Klassen EmailSubmitConnection und FileSubmitConnection zurückgegebene Objekt, um diese Werte abzurufen und festzulegen.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.XPathTypedValue
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class XPathTypedValue
'Usage
Dim instance As XPathTypedValue
public abstract class XPathTypedValue
Hinweise
Ein XPathTypedValue-Objekt wird von den folgenden Membern der EmailSubmitConnection-Klasse zurückgegeben, um ihre Werte abzurufen oder festzulegen:
Ein XPathTypedValue-Objekt wird durch die Filename-Eigenschaft der EmailSubmitConnection-Klasse zurückgegeben, um den Wert abzurufen oder festzulegen.
Zum Lesen oder Festlegen dieser Eigenschaften müssen Sie die Eigenschaften oder Methoden der XPathTypedValue-Klasse verwenden.
Sie können den Wert einer Eigenschaft festlegen, die ein XPathTypedValue-Objekt zurückgibt, indem Sie entweder eine Literalzeichenfolge oder einen XPath-Ausdruck angeben. Mit einem XPath-Ausdruck können Sie die Eigenschaft festlegen, indem Sie den Wert aus einem Feld in dem Formular (oder einem anderen Knoten in den Datenquellen des Formulars) abrufen. Außerdem können Sie XPath-Operatoren und -Funktionen verwenden, um andere Vorgänge für die abgerufenen Daten auszuführen.
Um den Wert einer Eigenschaft als Literalzeichenfolge festzulegen, verwenden Sie die SetStringValue-Methode der XPathTypedValue-Klasse.
Im folgenden Beispiel wird gezeigt, wie der Wert der To-Eigenschaft der EmailSubmitConnection-Klasse durch Angeben einer E-Mail-Adresse als Literalzeichenfolge mithilfe der SetStringValue-Methode festgelegt wird.
// Get the e-mail submit data connection configured for the form.
EmailSubmitConnection mySubmit = (EmailSubmitConnection)
(this.DataConnections["Email Submit"]);
// Set To property to literal string value.
mySubmit.To.SetStringValue("someone@example.com");
// Submit form.
mySubmit.Execute();
' Get the e-mail submit data connection configured for the form.
Dim mySubmit As EmailSubmitConnection = DirectCast(_
Me.DataConnections["Email Submit"], EmailSubmitConnection)
' Set To property to literal string value.
mySubmit.To.SetStringValue("someone@example.com")
' Submit form.
mySubmit.Execute()
Um den Wert einer Eigenschaft als XPath-Ausdruck festzulegen, verwenden Sie die XPath-Eigenschaft der XPathTypedValue-Klasse.
Das folgende Beispiel zeigt, wie der Wert der To-Eigenschaft der EmailSubmitConnection-Klasse festgelegt wird, indem eine E-Mail-Adresse als XPath-Ausdruck angegeben wird, der den Wert aus dem Feld ToAddress des Formulars mithilfe der XPath-Eigenschaft abruft.
// Get the e-mail submit data connection configured for the form.
EmailSubmitConnection mySubmit = (EmailSubmitConnection)
(this.DataConnections["Email Submit"]);
// Set To property to XPath for ToAddress field.
mySubmit.To.XPath = "/my:myFields/my:ToAddress";
// Submit form.
mySubmit.Execute();
' Get the e-mail submit data connection configured for the form.
Dim mySubmit As EmailSubmitConnection = DirectCast(_
Me.DataConnections["Email Submit"], EmailSubmitConnection)
' Set To property to XPath for ToAddress field.
mySubmit.To = "/my:myFields/my:ToAddress"
' Submit form.
mySubmit.Execute()
Zum Lesen der Werte von Eigenschaften, die als XPathTypedValue-Objekte zurückgegeben werden, verwenden Sie die Evaluate-Methode der XPathTypedValue-Klasse, um einen XPath-Ausdruck auszuwerten und das Ergebnis als Zeichenfolge zurückzugeben, oder verwenden Sie die ToString-Methode der XPathTypedValue-Klasse, um eine Literalzeichenfolge zurückzugeben.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.