FileSubmitConnection.Filename-Eigenschaft

Artikel
04/27/2010

Ruft ein XPathTypedValue-Objekt ab, das zu dem Dateinamen ausgewertet wird, den das aktuelle Formular erhält, wenn das Formular durch das FileSubmitConnection-Objekt gesendet wird.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride ReadOnly Property Filename As XPathTypedValue
'Usage
Dim instance As FileSubmitConnection
Dim value As XPathTypedValue

value = instance.Filename

public abstract XPathTypedValue Filename { get; }

Eigenschaftswert

Ein XPathTypedValue-Objekt, das zu dem Dateinamen ausgewertet wird, den das Formular erhält, wenn es gesendet wird.

Hinweise

Der Wert der Filename-Eigenschaft der FileSubmitConnection-Klasse wird als XPathTypedValue-Objekt zurückgegeben, das durch Angeben einer Literalzeichenfolge mithilfe der SetStringValue-Methode der XPathTypedValue-Klasse oder durch Angeben eines XPath-Ausdrucks mithilfe der XPath-Eigenschaft der XPathTypedValue-Klasse festgelegt werden kann. Weitere Informationen und Codebeispiele finden Sie in dem Thema zur XPathTypedValue-Klasse.

Die Dateinamenerweiterung XML wird nur dann der Zeichenfolge angefügt, wenn sie noch nicht vorhanden ist. Wenn für die Filename-Eigenschaft der Wert null festgelegt wird, erhält das Formular beim Senden den Namen "Form.xml".

Wenn beim Definieren der Datenverbindung ein XPath-Ausdruck, beispielsweise concat("Status Report -", field1), im Feld Dateiname desDatenverbindungs-Assistenten angegeben wurde, können Sie diesen Ausdruck mithilfe der XPath-Eigenschaft der XPathTypedValue-Klasse zurückgeben, wie im folgenden Beispiel gezeigt.

   FileSubmitConnection submitConnection = 
      (FileSubmitConnection)(DataConnections["SharePoint Library"]);
   MessageBox.Show (submitConnection.Filename.XPath.ToString());

   Dim submitConnection As FileSubmitConnection = 
      DirectCast(DataConnections["SharePoint Library"], _
      FileSubmitConnection)
   MessageBox.Show (submitConnection.Filename.XPath.ToString())

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.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird die Filename-Eigenschaft des FileSubmitConnection-Objekts verwendet, um den Dateinamen anzuzeigen, der beim Senden des Formulars an die Datenverbindung verwendet wird.

   FileSubmitConnection submitConnection = 
      (FileSubmitConnection)(DataConnections["SharePoint Library"]);
   MessageBox.Show (submitConnection.Filename.ToString());

   Dim submitConnection As FileSubmitConnection = 
      DirectCast(DataConnections["SharePoint Library"], _
      FileSubmitConnection)
   MessageBox.Show (submitConnection.Filename.ToString())

Siehe auch

Referenz

FileSubmitConnection-Klasse
FileSubmitConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über