Freigeben über

Application.RegisterFormTemplate-Methode (String, String)

  • Artikel

Installiert die angegebene Formularvorlage mit der Option zum Überschreiben des vorherigen Registrierungsdatensatzes für die Formularvorlage.

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustOverride Sub RegisterFormTemplate ( _
    formTemplateLocation As String, _
    behavior As String _
)
'Usage
Dim instance As Application
Dim formTemplateLocation As String
Dim behavior As String

instance.RegisterFormTemplate(formTemplateLocation, _
    behavior)

public abstract void RegisterFormTemplate(
    string formTemplateLocation,
    string behavior
)

Parameter

  • formTemplateLocation
    Typ: System.String

    Gibt den URI (Uniform Resource Identifier) der Formularvorlage an. Dieser Parameter kann als Formulardefinitionsdatei (XSF) oder als Formularvorlagendatei (XSN) angegeben werden.

  • behavior
    Typ: System.String

    Gibt an, wie die Formularvorlage installiert werden soll. Der Standardwert ist "overwrite". Außer dem Standardwert ist nur noch der Wert "new-only" für diesen Parameter zulässig.

Ausnahmen

Ausnahme Bedingung
FileNotFoundException

Die Formularvorlagendatei kann nicht gefunden werden.
ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic).
ArgumentException

Die an diese Methode übergebenen Parameter sind ungültig. Sie weisen beispielsweise den falschen Typ oder das falsche Format auf.

Hinweise

Wenn die Formularvorlage bereits registriert wurde und der Wert "new-only" für den behavior-Parameter angegeben wird, gibt die RegisterFormTemplate-Methode einen Fehler zurück. Bei Angabe des Wertes "overwrite" wird der Registrierungsdatensatz der Formularvorlage überschrieben.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Beispiele

Im folgenden Beispiel dient die RegisterFormTemplate-Methode der Application-Klasse in einer Funktion zum Installieren einer Formularvorlage. In diesem Beispiel wird davon ausgegangen, dass eine using- oder Imports-Anweisung für den Microsoft.Office.InfoPath-Namespace im Deklarationenabschnitt der Klasse vorhanden ist, die die Funktion enthält, und dass auf der Registerkarte COM im Dialogfeld Verweis hinzufügen in Visual Studio auf die Microsoft InfoPath 2.0-Typbibliothek verwiesen wird.

public void InstallForm()
{
Microsoft.Office.InfoPath.Application infoPathApp = 
   new Microsoft.Office.InfoPath.Application();
infoPathApp.RegisterFormTemplate(@"C:\My Forms\MyFormTemplate.xsn", 
   "overwrite");
}

Public Sub InstallForm()
Dim infoPathApp As Microsoft.Office.InfoPath.Application = _
   new Microsoft.Office.InfoPath.Application()
infoPathApp.RegisterFormTemplate("C:\My Forms\MyFormTemplate.xsn", _
   "overwrite")
End Sub

Berechtigungen

Siehe auch

Referenz

Application Klasse

Application-Member

RegisterFormTemplate-Überladung

Microsoft.Office.InfoPath-Namespace