Clase XPathTypedValue
Implementa el objeto devuelto por determinados valores de propiedad de las clases EmailSubmitConnection y FileSubmitConnection para obtener y establecer dichos valores.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.XPathTypedValue
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class XPathTypedValue
'Uso
Dim instance As XPathTypedValue
public abstract class XPathTypedValue
Comentarios
Los siguientes miembros de la clase EmailSubmitConnection devuelven un objeto XPathTypedValue para obtener o establecer sus valores:
La propiedad Filename de la clase EmailSubmitConnection devuelve un objeto XPathTypedValue para obtener o establecer su valor.
Para leer o establecer estas propiedades, debe usar las propiedades y los métodos de la clase XPathTypedValue.
Se puede establecer el valor de una propiedad que devuelve un objeto XPathTypedValue especificando una cadena literal o una expresión de XPath. Si se usa una expresión de XPath, se puede establecer la propiedad mediante la recuperación del valor desde un campo del formulario (o desde otro nodo de los orígenes de datos del formulario). Además, se pueden usar operadores y funciones de XPath para realizar otras operaciones con los datos recuperados.
Para establecer el valor de una propiedad en una cadena literal, se usa el método SetStringValue de la clase XPathTypedValue.
En el ejemplo siguiente, se muestra cómo establecer el valor de la propiedad To de la clase EmailSubmitConnection especificando una dirección de correo electrónico como cadena literal, mediante el método SetStringValue.
// 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()
Para establecer el valor de una propiedad en una expresión de XPath, se usa la propiedad XPath de la clase XPathTypedValue.
En el ejemplo siguiente se muestra cómo establecer el valor de la propiedad To de la clase EmailSubmitConnection especificando una dirección de correo electrónico como expresión de XPath que recupera el valor del campo ToAddress del formulario mediante la propiedad XPath.
// 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()
Para leer los valores de las propiedades devueltas como objetos XPathTypedValue, se usa el método Evaluate de la clase XPathTypedValue para evaluar una expresión de XPath y devolver su resultado como cadena o el método ToString de la clase XPathTypedValue para devolver una cadena literal.
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.