Freigeben über

Application.RegisterFormTemplate Methode

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll
Assembly:
Microsoft.Office.InfoPath.dll

Überlädt

RegisterFormTemplate(String)

Installiert die angegebene Formularvorlage.
RegisterFormTemplate(String, String)

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

RegisterFormTemplate(String)

Installiert die angegebene Formularvorlage.

public:
 abstract void RegisterFormTemplate(System::String ^ formTemplateLocation);
public abstract void RegisterFormTemplate(string formTemplateLocation);
abstract member RegisterFormTemplate : string -> unit
Public MustOverride Sub RegisterFormTemplate (formTemplateLocation As String)

Parameter

formTemplateLocation
String

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

Ausnahmen

FileNotFoundException

Die Formularvorlagendatei kann nicht gefunden werden.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

Hinweise

Wenn die Formularvorlage bereits registriert ist, wird der Registrierungsdatensatz der Formularvorlage überschrieben. Verwenden Sie stattdessen die RegisterFormTemplate(String, String) -Methode, um zu steuern, ob der Datensatz einer zuvor registrierten Formularvorlage überschrieben wird.

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.

Gilt für:

RegisterFormTemplate(String, String)

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

public:
 abstract void RegisterFormTemplate(System::String ^ formTemplateLocation, System::String ^ behavior);
public abstract void RegisterFormTemplate(string formTemplateLocation, string behavior);
abstract member RegisterFormTemplate : string * string -> unit
Public MustOverride Sub RegisterFormTemplate (formTemplateLocation As String, behavior As String)

Parameter

formTemplateLocation
String

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

behavior
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

FileNotFoundException

Die Formularvorlagendatei kann nicht gefunden werden.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

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

Beispiele

Im folgenden Beispiel wird die RegisterFormTemplate-Methode der Application -Klasse in einer Funktion verwendet, um eine Formularvorlage zu installieren. Im Beispiel wird davon ausgegangen, dass eine using - oder Imports-Anweisung für den Microsoft.Office.InfoPath-Namespace im Deklarationsabschnitt der Klasse vorhanden ist, die die Funktion enthält, und dass auf die Microsoft InfoPath 3.0-Typbibliothek auf der Registerkarte COM des Dialogfelds Verweis hinzufügen in Visual Studio 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

Hinweise

Wenn die Formularvorlage bereits registriert wurde und für den behavior Parameter "new-only" angegeben ist, 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.

Gilt für: