Grundlegendes zur Anpassungsdatei

Jeder Abschnittskopf in der Anpassungsdatei besteht aus eckigen Klammern ([]), die einen Typ und einen Parameter enthalten. Die vier Sektionstypen werden durch die Zeichenfolgen connect, sql, userlist, oder logs angegeben. Der Parameter ist die Zeichenfolge, die Voreinstellung, ein benutzerdefinierter Bezeichner.

Wichtig

Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.

Daher ist jeder Abschnitt mit einer der folgenden Abschnittsüberschriften gekennzeichnet:

  
[ connect default ] [ connect    
identifier   
] [ sql  default ] [ sql    
identifier   
] [ userlist    
identifier   
] [ logs ]  
  

Die Abschnittskopfzeilen bestehen aus den folgenden Teilen.

Teil	Beschreibung
connect	Eine Zeichenfolge, die eine Verbindungszeichenfolge modifiziert.
sql	Eine literale Zeichenfolge, die eine Befehlszeichenfolge modifiziert.
userlist	Eine literale Zeichenfolge, die die Zugriffsrechte eines bestimmten Benutzers ändert.
logs	Eine literale Zeichenfolge, die eine Protokolldatei angibt, die Betriebsfehler aufzeichnet.
default	Eine literale Zeichenfolge, die verwendet wird, wenn kein Bezeichner angegeben oder gefunden wird.
identifier	Eine Zeichenfolge, die mit einer Zeichenfolge in der Verbindungs- oder Befehlszeichenfolge übereinstimmt. - Verwenden Sie diesen Abschnitt, wenn die Abschnittskopfzeile connect enthält und die Bezeichnerzeichenfolge in der Verbindungszeichenfolge gefunden wird. - Verwenden Sie diesen Abschnitt, wenn die Abschnittskopfzeile sql enthält und die die Bezeichnerzeichenfolge in der Befehlszeichenfolge gefunden wird. - Verwenden Sie diesen Abschnitt, wenn die Abschnittskopfzeile userlist enthält und die Bezeichnerzeichenfolge mit einem connect-Abschnittsbezeichner übereinstimmt.

Die DataFactory ruft den Handler auf und übergibt dabei Client-Parameter. Der Handler durchsucht die Client-Parameter nach ganzen Zeichenfolgen, die mit den Bezeichnern in den entsprechenden Abschnittsüberschriften übereinstimmen. Wenn eine Übereinstimmung gefunden wird, wird der Inhalt dieses Abschnitts auf den Client-Parameter angewendet.

Ein bestimmter Abschnitt wird unter den folgenden Umständen verwendet:

• Ein connect-Abschnitt wird verwendet, wenn der Wert-Teil des Client-Connect-String-Schlüsselworts, "Data Source=value", mit dem Bezeichner eines connect-Abschnitts übereinstimmt.

• Ein sql-Abschnitt wird genutzt, wenn die Befehlszeichenfolge des Clients eine Zeichenfolge enthält, die mit einer sql-Abschnitt-Kennung übereinstimmt.

• Ein connect- oder sql-Abschnitt mit einem Standardparameter wird verwendet, wenn es keinen passenden Bezeichner gibt.

• Ein userlist-Abschnitt wird verwendet, wenn der Bezeichner des userlist-Abschnitts mit dem Bezeichner eines connect-Abschnitts übereinstimmt. Wenn es eine Übereinstimmung gibt, wird der Inhalt des Abschnitts userlist auf die Verbindung angewendet, die durch den Abschnitt connect geregelt wird.

• Wenn die Zeichenfolge in einem Verbindungs- oder Befehlsstring nicht mit dem Bezeichner in einem connect- oder sql-Abschnitt-Header übereinstimmt und es keinen connect- oder sql-Abschnitt-Header mit einem Standardparameter gibt, dann wird die Client-Zeichenfolge ohne Änderung verwendet.

• Der Abschnitt Protokolle wird immer dann verwendet, wenn die DataFactory in Betrieb ist.

Weitere Informationen

Connect-Abschnitt der Anpassungsdatei
Logs-Abschnitt der Anpassungsdatei
SQL-Abschnitt der Anpassungsdatei
UserList-Abschnitt der Anpassungsdatei
DataFactory-Anpassung
Erforderliche Clienteinstellungen
Schreiben Ihres eigenen benutzerdefinierten Handlers