Lokalem Kalender entsprechende Datums-/Uhrzeit-UDTs
Aktualisiert: 05. Dezember 2005
Das Speichern von Datumsangaben kann zu Verwirrung führen, da die Datumsangaben ohne Kenntnis des zugrunde liegenden Kalendersystems keinen Sinn ergeben.
Das CADatetime-Beispiel definiert zwei benutzerdefinierte Datentypen, CADatetime und CADate, für eine dem lokalen Kalender entsprechende Behandlung von Datums- und Uhrzeitangaben.
Installationsverzeichnis:
drive:\Programme\Microsoft SQL Server\90\Samples\Engine\Programmability\
CLR\CADateTime\
Szenario
Jane ist eine Entwicklerin für Adventure Works Cycles. Sie soll Software schreiben, die Datums- und Uhrzeitangaben aus aller Welt verarbeiten kann. Mithilfe von CADatetime- und CADate-UDTs erreicht sie, dass Datumsangaben nach einem bestimmten Kalendersystem wiedergegeben werden.
Sprachen
Transact-SQL, Visual C# und Visual Basic.
Features
Im CADatetime-Beispiel werden die folgenden Features von Microsoft SQL Server verwendet.
Anwendungsbereich | Features |
---|---|
UDT-Implementierung |
CLR |
World-ready |
Satellitenassemblys |
Voraussetzungen
Stellen Sie vor dem Ausführen dieses Beispiels sicher, dass die folgende Software installiert ist:
- SQL Server 2005 oder SQL Server 2005 Express Edition (SQL Server Express). Sie können SQL Server Express kostenlos von der Website mit der Dokumentation und Beispielen zu SQL Server 2005 Express Edition abrufen.
- Die AdventureWorks-Datenbank, die im Lieferumfang von SQL Server 2005 enthalten und auch auf der SQL Server Developer-Website verfügbar ist.
- Die Beispiele zu SQL Server 2005-Datenbankmodul. Diese Beispiele sind in SQL Server 2005 enthalten. Sie können die aktuelle Version der Beispiele von der SQL Server Developer-Website downloaden.
- .NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Das .NET Framework SDK ist kostenlos erhältlich. Weitere Informationen finden Sie unter Installieren des .NET Framework SDK.
Erstellen des Beispiels
Generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen, falls Sie noch keine Schlüsseldatei mit starkem Namen erstellt haben.
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 und danach auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.
– oder –
Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.
Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) im Eingabeaufforderungsfenster vom aktuellen Verzeichnis zu dem Ordner, in dem die Beispiele installiert sind.
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 <Systemlaufwerk>:\Programme\Microsoft SQL Server\100\Samples. Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:
sn -k SampleKey.snk
Wichtig: Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter ".NET-Entwicklung" auf der MSDN-Website.
So erstellen Sie das CADatetime-Beispiel
Erstellen Sie die Ressourcendateien für das Beispiel, indem Sie die folgenden Befehle entweder in einem SDK- oder in einem Visual Studio-Eingabeaufforderungsfenster ausführen.
cd CS\CADateTime\resources
build.cmd
cd ..\..\..
Kompilieren Sie das Beispiel mithilfe von Visual Studio 2005 und der bereitgestellten Visual Studio-Projektmappe oder mithilfe von Microsoft MSBuild, das im Lieferumfang von .NET Framework SDK 2.0 enthalten ist. Führen Sie an einer Eingabeaufforderung einen Befehl aus, der dem folgenden ähnelt:
msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ CADateTime.sln
Stellen Sie sicher, dass die AdventureWorks-Datenbank installiert ist.
Wenn Sie die Beispiele für SQL Server-Datenbankmodul nicht im Standardspeicherort installiert haben, ändern Sie den CREATE ASSEMBLY-Abschnitt des Skripts in Scripts\InstallCS.sql und Scripts\InstallVB.sql, um auf den Speicherort zu verweisen, in dem die Beispiele installiert wurden.
Wenn Sie keine Administratorrechte für die von Ihnen verwendete SQL Server-Instanz besitzen, müssen Sie sich von einem Administrator die CreateAssembly-Berechtigung erteilen lassen, um die Installation ausführen zu können.
Öffnen Sie die Datei scripts\installCS.sql bzw. scripts\installVB.sql (je nachdem, ob Sie das Visual C#-Projekt oder das Visual Basic-Projekt kompiliert haben) in Management Studio. Führen Sie das in der Datei enthaltene Skript aus, oder führen Sie einen ähnlichen Befehl wie den folgenden in einem Eingabeaufforderungsfenster aus:
sqlcmd -E -I -i Scripts\InstallCS.sql
Ausführen des Beispiels
So führen Sie das CADatetime-Beispiel aus
Öffnen Sie die Datei scripts\test.sql in Management Studio, und führen Sie das in der Datei enthaltene Skript aus. Führen Sie alternativ den folgenden Befehl in einem Eingabeaufforderungsfenster aus:
sqlcmd -E -I -i Scripts\test.sql
Entfernen des Beispiels
So entfernen Sie das CADatetime-Beispiel
Öffnen Sie die Datei scripts\cleanup.sql in SQL Server Management Studio, und führen Sie das in der Datei enthaltene Skript aus. Führen Sie alternativ den folgenden Befehl in einem Eingabeaufforderungsfenster aus:
sqlcmd -E -I -i Scripts\cleanup.sql
Kommentar
CLR für SQL Server 2005 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
Aufgaben
AdventureWorks Cycles CLR Layer
Hilfe und Informationen
Informationsquellen für SQL Server 2005
Änderungsverlauf
Version | Verlauf |
---|---|
05. Dezember 2005 |
|