Readme_Assembly Cleanup-Beispiel
[Dieses Thema ist eine Dokumentation zur Vorabversion und kann in zukünftigen Versionen geändert werden. Leere Themen sind als Platzhalter eingefügt. BITTE BEACHTEN SIE: Microsoft ist bestrebt, Ihnen möglichst viele Inhalte in deutscher Sprache anzubieten. Deshalb stellen wir Ihnen auch Dokumente zur Verfügung, die mit alternativen Verfahren übersetzt wurden. Der Inhalt der Dokumente dieser Vorabversion wurde zum Teil mithilfe solcher Verfahren übersetzt. Microsoft ist sich bewusst, dass ein auf diese Weise übersetztes Dokument nicht immer perfekt ist. Es kann Fehler in Bezug auf Wortwahl, Satzbau oder Grammatik enthalten. Für die Übersetzung der endgültigen Version dieses Inhalts werden herkömmliche Verfahren verwendet, sodass die Qualität der früherer Versionen entspricht.]
Dieses Beispiel funktioniert nur mit SQL Server 2005 und SQL Server 2008. In einer SQL Server-Version vor SQL Server 2005 kann das Beispiel nicht ausgeführt werden.
Das AssemblyCleanup-Beispiel enthält eine .NET-gespeicherte Prozedur, die mit Visual C# geschrieben wurde und die für nicht verwendete Assemblys in der aktuellen Datenbank ein Cleanup durchführt, indem sie die Metadatenkataloge abfragt.
Der einzige Parameter, visible_assemblies, wird verwendet, um anzugeben, ob nicht verwendete sichtbare Assemblys gelöscht werden sollen. Durch den Wert 'false' wird standardmäßig angegeben, dass nur nicht verwendete, unsichtbare Assemblys gelöscht werden, andernfalls werden alle nicht verwendeten Assemblys gelöscht.
Der Satz an nicht verwendeten Assemblys umfasst die Assemblys, für die kein Einstiegspunkt definiert ist (Routinen, Typen und Aggregate) und auf die keine anderen Assemblys direkt oder indirekt verweisen.
Hinweis
Beim Kompilieren von SQLCLR-Beispielen muss der Pfad der Version des mit SQL Server verteilten Microsoft .NET Framework-Compilers das erste Framework-Verzeichnis sein, das in der PATH-Umgebungsvariablen angegeben ist. Der Speicherort des in SQL Server enthaltenen Compilers ist entweder Laufwerk:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx oder Laufwerk:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, wobei Laufwerk für das Installationslaufwerk und xxxxx für die in SQL Server enthaltene .NET Framework-Versionsnummer steht.
Das Standardinstallationsverzeichnis ist C:\Programme\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\AssemblyCleanup.
SQL Server-Beispiele und -Beispieldatenbanken müssen heruntergeladen und installiert werden, bevor Sie sie anzeigen oder mit ihnen arbeiten können. Weitere Informationen finden Sie unter Überlegungen zum Installieren der SQL Server-Beispiele und -Beispieldatenbanken.
Szenario
Ein Entwickler möchte Bilder zwischen SQL Server und dem Dateisystem auf dem Server kopieren.
Sprachen
Transact-SQL, Visual C# und Visual Basic.
Voraussetzungen
Stellen Sie vor dem Ausführen dieses Beispiels sicher, dass die folgende Software installiert ist:
- SQL Server
Erstellen des Beispiels
Wenn Sie die Schlüsseldatei mit starkem Namen, ExternalSampleKey.snk, nicht bereits erstellt haben, generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen.
So generieren Sie eine Schlüsseldatei mit starkem Namen
Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft Visual Studio 2005 und auf Visual Studio Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.
- Oder -
Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.
Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) vom aktuellen Ordner im Eingabeaufforderungsfenster zum Ordner Samples.
Hinweis
Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <system_drive>:\Programme\Microsoft SQL Server\100\Samples.
Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus.
sn -k ExternalSampleKey.snk
Wichtig
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Strong Names and Security in the .NET Framework" (in Englisch) im .NET Development Center auf der MSDN-Website.
Um dieses Beispiel zu erstellen, gehen Sie wie folgt vor:
Beispielerstellung
Kompilieren Sie das Beispiel mithilfe der bereitgestellten Microsoft Visual Studio-Lösungen, oder indem Sie an der Eingabeaufforderung einen Befehl ähnlich dem folgenden ausführen:
Sn -k keypair.snk
Csc /reference:"C:\Program Files\Microsoft SQL Server\MSSQL.10.MSSQLSERVER\MSSQL\Binn\sqlaccess.dll" /target:library /debug /out:CS\AssemblyCleanup\Bin\Debug\AssemblyCleanup.dll CS\AssemblyCleanup\*.cs
Stellen Sie sicher, dass die AdventureWorks-Datenbank installiert ist, oder erstellen Sie ggf. die Datenbank, in der Sie die Beispiele installieren möchten.
Laden Sie das Transact-SQL-Skript unter Scripts\installCS.sql oder Scripts\installVB.sql in Management Studio, und führen Sie es aus. Diese Datei enthält Skripts zum Installieren und Registrieren der CLR-Objekte in SQL Server.
Ausführen des Beispiels
Um dieses Beispiel auszuführen, gehen Sie wie folgt vor:
Beispielausführung
So laden Sie das Transact-SQL-Skript unter Scripts\test.sql in Management Studio, und führen Sie es aus. Das Skript zeigt typische Verwendungsweisen des Beispiels.
Wenn Sie die Arbeit am Beispiel beendet haben, laden Sie das Skript Transact-SQL unter Scripts\cleanup.sql in Management Studio, und führen Sie es aus. Dieses Skript entfernt das Beispiel.
Entfernen des Beispiels
Um das Beispiel zu entfernen, gehen Sie wie folgt vor:
Beispielentfernung
Öffnen Sie die Datei scripts\cleanup.sql in Management Studio, und führen Sie das in der Datei enthaltene Skript aus. Führen Sie alternativ den folgenden Befehl an der Eingabeaufforderung aus:
sqlcmd -E -I -i Scripts\cleanup.sql
Kommentar
Die CLR für SQL Server oder SQL Server Express muss aktiviert sein, damit dieses Beispiel ordnungsgemäß ausgeführt werden kann.
Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für den Einsatz in einer Produktionsumgebung gedacht und wurden auch nicht in einer Produktionsumgebung getestet. Microsoft leistet keinen technischen Support für diese Beispiele. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden.
Siehe auch
Konzepte
Beispiele für die CLR-Programmierbarkeit
Andere Ressourcen
Large Binary Object (LOB) Handling using ADO.Net
Programmierkonzepte für die Common Language Runtime (CLR)-Integration