Partager via

Exemple Readme_Calendar-Aware Date/Time UDT

  • Article

Cet exemple fonctionne uniquement avec SQL Server 2005 et SQL Server 2008. Il ne fonctionnera pas avec les versions de SQL Server antérieures à SQL Server 2005.

Le stockage de dates en tant que chaînes peut prêter à confusion, car les dates n'ont une signification qu'à partir du moment où vous comprenez le système calendaire utilisé.

L'exemple CADatetime définit deux types de données définis par l'utilisateur (CADatetime et CADate) qui fournissent une gestion des dates et des heures prenant en charge le calendrier.

Répertoire d'installation :

C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\

CLR\CADateTime\

Les exemples SQL Server et les exemples de bases de données doivent être téléchargés et installés avant que vous ne puissiez les afficher ou les utiliser. Pour plus d'informations, consultez Considérations relatives à l'installation d'exemples de bases de données et d'exemples de code SQL Server.

Scénario

Jane travaille au service Développement de la société Adventure Works Cycles. Elle est chargée d'écrire un logiciel qui traite les dates et les heures du monde entier. Elle utilise les types définis par l'utilisateur (UDT) CADatetime et CADate afin d'exprimer les dates dans un système calendaire particulier.

Langages

Transact-SQL, Visual C# et Visual Basic.

Fonctionnalités

L'exemple CADatetime utilise les fonctionnalités suivantes de Microsoft SQL Server.

Domaine d'application Fonctionnalités

Implémentation d'UDT

CLR

Compatible dans le monde entier

Assemblys satellites

Configuration requise

Avant d'exécuter cet exemple, assurez-vous que les logiciels suivants sont installés :

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

  1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

    -- ou --

    Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

  2. Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

    ms161559.note(fr-fr,SQL.100).gifRemarque :
    Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

  3. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

    sn -k SampleKey.snk

    ms161559.note(fr-fr,SQL.100).gifImportant :
    Pour plus d'informations sur la paire de clés avec nom fort, consultez « Security Briefs: Strong Names and Security in the .NET Framework » (en anglais) dans le Centre de Développement du .NET sur MSDN.

Pour générer l'exemple CADatetime

  1. Générez les fichiers de ressources de l'exemple en exécutant les commandes suivantes dans une fenêtre d'invite de commandes SDK ou Visual Studio :

    cd CS\CADateTime\resources

    build.cmd

    cd ..\..\..

  2. Compilez l'exemple au moyen de Visual Studio 2005 et de la solution Visual Studio fournie, ou à l'aide de Microsoft MSBuild disponible dans le Kit de développement logiciel .NET Framework SDK 2.0. À une invite de commandes, exécutez une commande semblable à la suivante :

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\CADateTime.sln

  3. Assurez-vous que la base de données AdventureWorks est installée.

  4. Si vous n'avez pas installé les exemples du moteur de base de données SQL Server à l'emplacement par défaut, modifiez le chemin d'accès dans la partie CREATE ASSEMBLY du script qui se trouve dans Scripts\InstallCS.sql et Scripts\InstallVB.sql de sorte qu'ils fassent référence à l'emplacement où ont été installés les exemples.

  5. Si vous n'êtes pas administrateur de l'instance SQL Server que vous utilisez, vous devez demander à un administrateur de vous accorder l'autorisation CreateAssembly afin de procéder à l'installation.

  6. Ouvrez le fichier scripts\installCS.sql ou scripts\installVB.sql, selon que vous avez compilé le projet Visual C# ou Visual Basic, dans Management Studio. Exécutez le script contenu dans le fichier ou exécutez une commande semblable à la suivante dans une fenêtre d'invite de commandes :

    sqlcmd -E -I -i Scripts\InstallCS.sql

Exécution de l'exemple

Pour exécuter l'exemple CADatetime

  1. Ouvrez le fichier scripts\test.sql dans Management Studio et exécutez le script que contient le fichier. Vous pouvez aussi exécuter la commande suivante dans une fenêtre d'invite de commandes :

    sqlcmd -E -I -i Scripts\test.sql

Suppression de l'exemple

Pour supprimer l'exemple CADatetime

  1. Ouvrez le fichier scripts\cleanup.sql dans SQL Server Management Studio et exécutez le script que contient le fichier. Vous pouvez aussi exécuter la commande suivante dans une fenêtre d'invite de commandes :

    sqlcmd -E -I -i Scripts\cleanup.sql

Commentaires

Pour que cet exemple fonctionne correctement, le CLR pour SQL Server ou SQL Server Express doit être activé.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Voir aussi

Tâches

Exemple Readme_AdventureWorks Cycles CLR Layer

Aide et informations

Assistance sur SQL Server 2008