• Article

Classe MasterKey

The MasterKey object represents a SQL Server database master key.

Hiérarchie d'héritage

System. . :: . .Object
  Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
    Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
      Microsoft.SqlServer.Management.Smo..::..MasterKey

Espace de noms :  Microsoft.SqlServer.Management.Smo
Assembly :  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Syntaxe

'Déclaration
Public NotInheritable Class MasterKey _
    Inherits SqlSmoObject _
    Implements ISfcSupportsDesignMode, IDroppable
'Utilisation
Dim instance As MasterKey

public sealed class MasterKey : SqlSmoObject, 
    ISfcSupportsDesignMode, IDroppable

public ref class MasterKey sealed : public SqlSmoObject, 
    ISfcSupportsDesignMode, IDroppable

[<SealedAttribute>]
type MasterKey =  
    class
        inherit SqlSmoObject
        interface ISfcSupportsDesignMode
        interface IDroppable
    end

public final class MasterKey extends SqlSmoObject implements ISfcSupportsDesignMode, IDroppable

Le type MasterKey expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique MasterKey() () () () Initializes a new instance of the MasterKey class.
Méthode publique MasterKey(Database) Initializes a new instance of the MasterKey class on the specified database.

Haut de la page

Propriétés

  Nom Description
Propriété publique CreateDate Gets the date and time when the master key was created.
Propriété publique DateLastModified Gets the date and time when the master key was last modified.
Propriété protégée ExecuteForScalar Obtient ou définit la valeur de la propriété Boolean qui spécifie si l'objet est défini selon l'option permettant l'exécution qui retourne une valeur scalaire. (hérité de SqlSmoObject.)
Propriété publique IsEncryptedByServer Gets the Boolean property value that specifies whether the database master key is encrypted by using the service master key or by using a password.
Propriété publique IsOpen Gets the Boolean property value that specifies whether the database master key is open.
Propriété protégée IsTouched Obtient la valeur de la propriété Boolean qui spécifie si les propriétés de l'objet ont été mises à jour mais n'ont pas encore été rendues persistantes sur le serveur. (hérité de SqlSmoObject.)
Propriété protégée ObjectInSpace Obtient la valeur de la propriété Boolean qui spécifie si l'objet existe dans l'isolation, ou s'il est connecté directement ou indirectement à l'instance de SQL Server. (hérité de SqlSmoObject.)
Propriété publique Parent Gets the Database object that is the parent of the MasterKey object.
Propriété publique Properties Obtient une collection d'objets Property qui représentent les propriétés de l'objet. (hérité de SqlSmoObject.)
Propriété protégée ScalarResult Obtient le résultat scalaire pour l'objet référencé. (hérité de SqlSmoObject.)
Propriété publique State Gets the state of the referenced object. (hérité de SmoObjectBase.)
Propriété publique Urn Obtient la valeur URN (Uniform Resource Name) qui identifie de façon unique l'objet. (hérité de SqlSmoObject.)
Propriété publique UserData Gets or sets user-defined data associated with the referenced object. (hérité de SmoObjectBase.)

Haut de la page

Méthodes

  Nom Description
Méthode protégée AddDatabaseContext(StringCollection) Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries. (hérité de SqlSmoObject.)
Méthode protégée AddDatabaseContext(StringCollection, ScriptingOptions) Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries, à l'aide des options de script spécifiées. (hérité de SqlSmoObject.)
Méthode publique AddPasswordEncryption Adds password encryption to the master key.
Méthode publique AddServiceKeyEncryption Adds service key encryption to the master key.
Méthode protégée AlterImpl Active l'événement d'objet modifié. (hérité de SqlSmoObject.)
Méthode protégée AlterImplFinish Méthode appelée lorsque l'événement d'objet modifié est terminé. (hérité de SqlSmoObject.)
Méthode protégée AlterImplInit Méthode appelée lorsque l'événement d'objet modifié est initialisé. (hérité de SqlSmoObject.)
Méthode protégée AlterImplWorker Appelle les méthodes de modification. (hérité de SqlSmoObject.)
Méthode protégée BindDefaultImpl Lie les éléments par défaut identifiés par les paramètres. (hérité de SqlSmoObject.)
Méthode protégée BindRuleImpl Lie le schéma de règle à la règle et aux colonnes identifiées par les paramètres. (hérité de SqlSmoObject.)
Méthode protégée CheckCollation Vérifie l'ordre des options de script par la méthode de classement identifiée par le paramètre collationName. (hérité de SqlSmoObject.)
Méthode protégée CheckObjectState() () () () Valide l'état de l'objet référencé. (hérité de SqlSmoObject.)
Méthode protégée CheckObjectState(Boolean) Valide l'état de l'objet référencé avec l'option permettant de spécifier qu'une exception est levée si l'objet n'est pas encore créé. (hérité de SqlSmoObject.)
Méthode protégée CheckObjectStateImpl Vérifie l'état de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée CheckVersion100 Vérifie si la version de SQL Server est SQL Server 2008. (hérité de SqlSmoObject.)
Méthode protégée CheckVersion80 Vérifie la validité de l'objet sur SQL Server 2000. (hérité de SqlSmoObject.)
Méthode protégée CheckVersion80SP3 Vérifie la validité de l'objet sur SQL Server 2000 SP3. (hérité de SqlSmoObject.)
Méthode protégée CheckVersion90 Vérifie la validité de l'objet sur SQL Server 2005. (hérité de SqlSmoObject.)
Méthode protégée CheckVersionBelow90 Vérifie si la version de SQL Server est antérieure à SQL Server 2005. (hérité de SqlSmoObject.)
Méthode protégée CleanObject Définit l'objet sur l'état non modifié. (hérité de SqlSmoObject.)
Méthode publique Close Closes the master key.
Méthode publique Create(String) Creates a master key that has the specified password.
Méthode publique Create(String, String, String) Creates a master key from the specified file and that has the specified encryption and decryption passwords.
Méthode protégée CreateImpl Crée un objet avec les options de script. (hérité de SqlSmoObject.)
Méthode protégée CreateImplFinish Méthode appelée lorsque l'événement de création est terminé. (hérité de SqlSmoObject.)
Méthode protégée CreateImplInit Méthode appelée lorsque l'événement de création est initialisé. (hérité de SqlSmoObject.)
Méthode publique Discover Découvre une liste de type Object. (hérité de SqlSmoObject.)
Méthode publique Drop Removes the master key from the database.
Méthode protégée DropImpl Supprime un SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée DropImplWorker Appelle les méthodes de suppression. (hérité de SqlSmoObject.)
Méthode publique DropPasswordEncryption Removes the password encryption from the master key by using the associated password.
Méthode publique DropServiceKeyEncryption Drops service key encryption from the master key.
Méthode publique EnumKeyEncryptions Enumerates a list of the current set of key encryptions for the database master key.
Méthode protégée EnumScriptImpl Énumère des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.)
Méthode protégée EnumScriptImplWorker Appelle les méthodes qui énumèrent des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.)
Méthode protégée EnumScriptImplWorkerSOChanged Retourne une chaîne IEnumerable qui décrit les options de script pour un objet. (hérité de SqlSmoObject.)
Méthode publique Equals (hérité de Object.)
Méthode protégée ExecuteNonQuery (hérité de SqlSmoObject.)
Méthode publique Export Saves the database master key to the specified system path location by using the specified password.
Méthode protégée Finalize (hérité de Object.)
Méthode protégée FormatSqlVariant Met en forme un objet en tant que type SqlVariant. (hérité de SqlSmoObject.)
Méthode protégée GenerateDataSpaceFileStreamScript Génère un script pour créer un fichier de données. (hérité de SqlSmoObject.)
Méthode protégée GenerateDataSpaceScript Génère un script pour allouer l'espace dans le fichier de données. (hérité de SqlSmoObject.)
Méthode protégée GetBindDefaultScript Obtient le script qui lie les valeurs par défaut spécifiées par les paramètres defName et defSchema. (hérité de SqlSmoObject.)
Méthode protégée GetBindRuleScript Obtient le script qui spécifie les règles de liaison. (hérité de SqlSmoObject.)
Méthode protégée GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Affecte un paramètre booléen du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Affecte une propriété booléenne du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetDateTimeParameter Affecte une propriété datetime du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetDateTimeParameterAsInt Affecte la propriété datetime du SqlSmoObject comme une valeur entière, si la propriété datetime n'est pas Null. (hérité de SqlSmoObject.)
Méthode protégée GetDBName Obtient le nom de la base de données associée à l'objet. (hérité de SqlSmoObject.)
Méthode protégée GetEnumParameter Affecte une propriété d'énumération du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetFragOptionString Obtient un objet FragmentationOption en tant que valeur de chaîne. (hérité de SqlSmoObject.)
Méthode protégée GetGuidParameter Affecte une propriété Guid du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode publique GetHashCode (hérité de Object.)
Méthode protégée GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetPropValue Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetPropValueOptional Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetPropValueOptionalAllowNull Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetRealValue Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetScriptingOptionsForCreate Obtient ScriptingOptions pour l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetServerName Obtient le nom de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.)
Méthode protégée GetServerObject Obtient le serveur de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetSqlServerVersionName Obtient le nom de version de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.)
Méthode protégée GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetTimeSpanParameterAsInt Affecte un paramètre d'intervalle de temps de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode publique GetType (hérité de Object.)
Méthode protégée GetUrnRecursive(StringBuilder) Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée GetUrnRecursive(StringBuilder, UrnIdOption) Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée ImplInitialize Initialise les champs de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
Méthode publique Import(String, String, String) Loads the database master key from the file that is located at the specified system path by using the specified passwords to decrypt and encrypt the master key.
Méthode publique Import(String, String, String, Boolean) Loads the database master key from the file that is located at the specified system path by using the specified passwords to decrypt and encrypt the master key, and with the option to force regeneration.
Méthode publique Initialize() () () () Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.)
Méthode publique Initialize(Boolean) Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.)
Méthode protégée IsObjectDirty Vérifie si les propriétés de l'objet ont été modifiées et si les modifications n'ont pas encore été rendues persistantes sur l'instance de SQL Server. (hérité de SqlSmoObject.)
Méthode protégée IsObjectInitialized Vérifie si l'objet a été initialisé. (hérité de SqlSmoObject.)
Méthode protégée IsObjectInSpace Vérifie si l'objet est isolé ou connecté à l'instance de SQL Server. (hérité de SqlSmoObject.)
Méthode protégée IsVersion80SP3 Détermine si la version de SQL Server est SQL Server 2000 avec SP3. (hérité de SqlSmoObject.)
Méthode protégée IsVersion90AndAbove Détermine si la version de SQL Server est SQL Server 2005 ou une version ultérieure. (hérité de SqlSmoObject.)
Méthode protégée MarkDropped Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.)
Méthode protégée MarkForDropImpl Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.)
Méthode protégée MemberwiseClone (hérité de Object.)
Méthode publique Open Opens the database master key by using the specified password.
Méthode protégée PostAlter Méthode activée après la modification du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée PostCreate Méthode activée après la création du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée PostDrop Méthode activée après la suppression du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode publique Refresh Actualise l'objet et récupère les propriétés lors du prochain accès à l'objet. (hérité de SqlSmoObject.)
Méthode publique Regenerate(String) Regenerates the database master key by using the specified new password.
Méthode publique Regenerate(String, Boolean) Regenerates the database master key by using the specified new password, and with the option to force the regeneration, thus removing all items that cannot be successfully decrypted.
Méthode protégée ScriptAlter Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.)
Méthode protégée ScriptCreate Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.)
Méthode protégée ScriptDdl Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.)
Méthode protégée ScriptDrop Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.)
Méthode protégée ScriptImpl() () () () Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée ScriptImpl(ScriptingOptions) Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée ScriptImplWorker Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée SetParentImpl Définit le parent du SqlSmoObject sur le paramètre newParent. (hérité de SqlSmoObject.)
Méthode publique ToString Retourne un String qui représente l'objet référencé. (hérité de SqlSmoObject.)
Méthode protégée TouchImpl Non implémenté. (hérité de SqlSmoObject.)
Méthode protégée UnbindDefaultImpl Annule la liaison des colonnes par défaut du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode protégée UnbindRuleImpl Annule la liaison des règles du SqlSmoObject. (hérité de SqlSmoObject.)
Méthode publique Validate Validates the state of an object. (hérité de SmoObjectBase.)

Haut de la page

Événements

  Nom Description
Événement public PropertyChanged Représente l'événement qui se produit lorsqu'une propriété est modifiée. (hérité de SqlSmoObject.)
Événement public PropertyMetadataChanged Représente l'événement qui se produit lorsque les métadonnées de la propriété sont modifiées. (hérité de SqlSmoObject.)

Haut de la page

Champs

  Nom Description
Champ protégé m_ExtendedProperties Représente une propriété définie pour étendre les propriétés fournies par un SqlSmoObject. (hérité de SqlSmoObject.)
Champ protégé singletonParent Représente le parent de singleton. (hérité de SqlSmoObject.)

Haut de la page

Implémentations d'interfaces explicites

  Nom Description
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .Discover Découvre les éventuelles dépendances. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .GetDomainRoot Retourne la racine du domaine. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .GetParent Obtient le parent de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .GetPropertyType Obtient le type de la propriété spécifiée. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .GetPropertyValue Obtient la valeur de la propriété spécifiée. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .GetUrn Obtient l'URN (Uniform Resource Name) de l'objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .Resolve Obtient l'instance qui contient les informations relatives à l'objet de l'URN (Unified Resource Name) de l'objet. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .SetObjectState Définit l'état de l'objet sur la valeur SfcObjectState spécifiée. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée IAlienObject. . :: . .SetPropertyValue Définit la valeur de la propriété. (hérité de SqlSmoObject.)
Implémentation d'interface expliciteMéthode privée ISfcPropertyProvider. . :: . .GetPropertySet Obtient la référence d'interface au jeu de propriétés de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
Implémentation d'interface explicitePropriété privée ISfcSupportsDesignMode. . :: . .IsDesignMode Gets a Boolean value that indicates whether the object supports design mode. Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Haut de la page

Notes

A database master key is used to symmetrically encrypt keys and certificates that are stored in the database. A database master key can be encrypted by using the service master key or by using a user-specified password. When a database master key is created, a password must be supplied to encrypt and decrypt it.

When a database is attached to an instance of SQL Server, the database administrator must either supply the master key password or make an unencrypted copy of the master key that is available for encryption with the service master key.

The service master key is the top layer in the encryption hierarchy that is used to encrypt lower layers in the encryption hierarchy. The service master key is generated automatically by Windows. It can be opened only by the Windows service account under which it was created, or by a user who knows both the service account name and its password.

To get MasterKey object properties, users can be a member of the public fixed server role.

To set MasterKey object properties, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.

To create or drop a master key, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.

To open or regenerate a master key, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.

To add or drop service key encryption, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.

To drop a master key, users can be a member of the public fixed server role.

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.