Condividi tramite

  • Articolo

Classe MasterKey

The MasterKey object represents a SQL Server database master key.

Gerarchia di ereditarietà

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

Spazio dei nomi  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Sintassi

'Dichiarazione
Public NotInheritable Class MasterKey _
    Inherits SqlSmoObject _
    Implements ISfcSupportsDesignMode, IDroppable
'Utilizzo
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

Nel tipo MasterKey sono esposti i membri seguenti.

Costruttori

  Nome Descrizione
Metodo pubblico MasterKey() () () () Initializes a new instance of the MasterKey class.
Metodo pubblico MasterKey(Database) Initializes a new instance of the MasterKey class on the specified database.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica CreateDate Gets the date and time when the master key was created.
Proprietà pubblica DateLastModified Gets the date and time when the master key was last modified.
Proprietà protetta ExecuteForScalar Ottiene o imposta il valore della proprietà Boolean che specifica se l'oggetto viene impostato su Esegui per l'opzione scalare. Ereditato da SqlSmoObject.
Proprietà pubblica 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.
Proprietà pubblica IsOpen Gets the Boolean property value that specifies whether the database master key is open.
Proprietà protetta IsTouched Ottiene il valore della proprietà Boolean che specifica se le proprietà dell'oggetto sono state aggiornate ma non sono ancora persistenti nel server. Ereditato da SqlSmoObject.
Proprietà protetta ObjectInSpace Ottiene il valore della proprietà Boolean che specifica se l'oggetto esiste in isolamento o se è connesso direttamente o indirettamente all'istanza di SQL Server. Ereditato da SqlSmoObject.
Proprietà pubblica Parent Gets the Database object that is the parent of the MasterKey object.
Proprietà pubblica Properties Ottiene una raccolta di oggetti Property che rappresentano le proprietà dell'oggetto. Ereditato da SqlSmoObject.
Proprietà protetta ScalarResult Ottiene il risultato scalare per l'oggetto a cui si fa riferimento. Ereditato da SqlSmoObject.
Proprietà pubblica State Gets the state of the referenced object. Ereditato da SmoObjectBase.
Proprietà pubblica Urn Ottiene il valore dell'indirizzo URN (Uniform Resource Name) che identifica in modo univoco l'oggetto. Ereditato da SqlSmoObject.
Proprietà pubblica UserData Gets or sets user-defined data associated with the referenced object. Ereditato da SmoObjectBase.

In alto

Metodi

  Nome Descrizione
Metodo protetto AddDatabaseContext(StringCollection) Aggiungere il contesto del database alla raccolta di query identificate dal parametro queries. Ereditato da SqlSmoObject.
Metodo protetto AddDatabaseContext(StringCollection, ScriptingOptions) Aggiungere il contesto del database alla raccolta di query identificate dal parametro queries e utilizzando le opzioni di scripting specificate. Ereditato da SqlSmoObject.
Metodo pubblico AddPasswordEncryption Adds password encryption to the master key.
Metodo pubblico AddServiceKeyEncryption Adds service key encryption to the master key.
Metodo protetto AlterImpl Attiva l'evento modificato dall'oggetto. Ereditato da SqlSmoObject.
Metodo protetto AlterImplFinish Metodo chiamato quando l'evento modificato dall'oggetto viene completato. Ereditato da SqlSmoObject.
Metodo protetto AlterImplInit Metodo chiamato quando l'evento modificato dall'oggetto viene inizializzato. Ereditato da SqlSmoObject.
Metodo protetto AlterImplWorker Chiama i metodi Alter. Ereditato da SqlSmoObject.
Metodo protetto BindDefaultImpl Associa gli elementi predefiniti identificati dai parametri. Ereditato da SqlSmoObject.
Metodo protetto BindRuleImpl Associa lo schema della regola alla regola e alle colonne identificate dai parametri. Ereditato da SqlSmoObject.
Metodo protetto CheckCollation Verifica l'ordine delle opzioni di scripting mediante il metodo delle regole di confronto identificato dal parametro collationName. Ereditato da SqlSmoObject.
Metodo protetto CheckObjectState() () () () Convalida lo stato dell'oggetto a cui si fa riferimento. Ereditato da SqlSmoObject.
Metodo protetto CheckObjectState(Boolean) Convalida lo stato dell'oggetto a cui si fa riferimento con l'opzione che specifica di generare un'eccezione se l'oggetto non è stato ancora creato. Ereditato da SqlSmoObject.
Metodo protetto CheckObjectStateImpl Verifica lo stato di un oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion100 Verifica se la versione di SQL Server è SQL Server 2008. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion80 Verifica la validità dell'oggetto in SQL Server 2000. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion80SP3 Verifica la validità dell'oggetto in SQL Server 2000 SP3. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion90 Verificare la validità dell'oggetto in SQL Server 2005. Ereditato da SqlSmoObject.
Metodo protetto CheckVersionBelow90 Verifica se la versione di SQL Server è precedente a SQL Server 2005. Ereditato da SqlSmoObject.
Metodo protetto CleanObject Imposta l'oggetto su uno stato non modificato. Ereditato da SqlSmoObject.
Metodo pubblico Close Closes the master key.
Metodo pubblico Create(String) Creates a master key that has the specified password.
Metodo pubblico Create(String, String, String) Creates a master key from the specified file and that has the specified encryption and decryption passwords.
Metodo protetto CreateImpl Crea un oggetto con opzioni di scripting. Ereditato da SqlSmoObject.
Metodo protetto CreateImplFinish Metodo chiamato quando l'evento Create viene completato. Ereditato da SqlSmoObject.
Metodo protetto CreateImplInit Metodo chiamato quando l'evento Create viene inizializzato. Ereditato da SqlSmoObject.
Metodo pubblico Discover Individua un elenco di tipo Object. Ereditato da SqlSmoObject.
Metodo pubblico Drop Removes the master key from the database.
Metodo protetto DropImpl Elimina un oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto DropImplWorker Chiama i metodi Drop. Ereditato da SqlSmoObject.
Metodo pubblico DropPasswordEncryption Removes the password encryption from the master key by using the associated password.
Metodo pubblico DropServiceKeyEncryption Drops service key encryption from the master key.
Metodo pubblico EnumKeyEncryptions Enumerates a list of the current set of key encryptions for the database master key.
Metodo protetto EnumScriptImpl Enumera gli script specificati dal parametro so. Ereditato da SqlSmoObject.
Metodo protetto EnumScriptImplWorker Chiama i metodi che enumerano gli script specificati dal parametro so. Ereditato da SqlSmoObject.
Metodo protetto EnumScriptImplWorkerSOChanged Restituisce una stringa IEnumerable che descrive le opzioni di scripting per un oggetto. Ereditato da SqlSmoObject.
Metodo pubblico Equals Ereditato da Object.
Metodo protetto ExecuteNonQuery Ereditato da SqlSmoObject.
Metodo pubblico Export Saves the database master key to the specified system path location by using the specified password.
Metodo protetto Finalize Ereditato da Object.
Metodo protetto FormatSqlVariant Formatta un oggetto come tipo SqlVariant. Ereditato da SqlSmoObject.
Metodo protetto GenerateDataSpaceFileStreamScript Genera uno script per creare file di dati. Ereditato da SqlSmoObject.
Metodo protetto GenerateDataSpaceScript Genera uno script per allocare spazio nel file di dati. Ereditato da SqlSmoObject.
Metodo protetto GetBindDefaultScript Ottiene lo script che associa le impostazioni predefinite specificate dai parametri defSchema e defName. Ereditato da SqlSmoObject.
Metodo protetto GetBindRuleScript Ottiene lo script che specifica le regole di associazione. Ereditato da SqlSmoObject.
Metodo protetto GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Assegna un parametro booleano dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Assegna una proprietà booleana dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetDateTimeParameter Assegna la proprietà datetime dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetDateTimeParameterAsInt Assegna la proprietà datetime dell'oggetto SqlSmoObject come valore intero se la proprietà datetime è diversa da null. Ereditato da SqlSmoObject.
Metodo protetto GetDBName Ottiene il nome del database associato all'oggetto. Ereditato da SqlSmoObject.
Metodo protetto GetEnumParameter Assegna una proprietà di enumerazione dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetFragOptionString Ottiene un oggetto FragmentationOption come valore stringa. Ereditato da SqlSmoObject.
Metodo protetto GetGuidParameter Assegna una proprietà Guid dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico GetHashCode Ereditato da Object.
Metodo protetto GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Assegna un parametro dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Assegna un parametro dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetPropValue Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetPropValueOptional Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetPropValueOptionalAllowNull Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetRealValue Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetScriptingOptionsForCreate Ottiene l'oggetto ScriptingOptions per l'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetServerName Ottiene il nome dell'istanza di SQL Server a cui è associato l'oggetto. Ereditato da SqlSmoObject.
Metodo protetto GetServerObject Ottiene il server dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetSqlServerVersionName Ottiene il nome della versione dell'istanza di SQL Server a cui è associato l'oggetto. Ereditato da SqlSmoObject.
Metodo protetto GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Assegna un parametro stringa dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Assegna un parametro stringa dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetTimeSpanParameterAsInt Assegna un parametro periodo di tempo dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico GetType Ereditato da Object.
Metodo protetto GetUrnRecursive(StringBuilder) Assegna un oggetto Urn dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetUrnRecursive(StringBuilder, UrnIdOption) Assegna un oggetto Urn dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ImplInitialize Inizializza i campi dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico 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.
Metodo pubblico 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.
Metodo pubblico Initialize() () () () Inizializza l'oggetto e forza il caricamento delle proprietà. Ereditato da SqlSmoObject.
Metodo pubblico Initialize(Boolean) Inizializza l'oggetto e forza il caricamento delle proprietà. Ereditato da SqlSmoObject.
Metodo protetto IsObjectDirty Verifica se le proprietà dell'oggetto sono state modificate e se le modifiche non sono già persistenti nell'istanza di SQL Server. Ereditato da SqlSmoObject.
Metodo protetto IsObjectInitialized Verifica se l'oggetto è stato inizializzato. Ereditato da SqlSmoObject.
Metodo protetto IsObjectInSpace Verifica se l'oggetto è isolato o connesso all'istanza di SQL Server. Ereditato da SqlSmoObject.
Metodo protetto IsVersion80SP3 Determina se la versione di SQL Server è SQL Server 2000 con SP3. Ereditato da SqlSmoObject.
Metodo protetto IsVersion90AndAbove Determina se la versione di SQL Server è SQL Server 2005 o successiva. Ereditato da SqlSmoObject.
Metodo protetto MarkDropped Imposta l'oggetto SqlSmoState da eliminare. Ereditato da SqlSmoObject.
Metodo protetto MarkForDropImpl Imposta l'oggetto SqlSmoState da eliminare. Ereditato da SqlSmoObject.
Metodo protetto MemberwiseClone Ereditato da Object.
Metodo pubblico Open Opens the database master key by using the specified password.
Metodo protetto PostAlter Metodo attivato dopo che l'oggetto SqlSmoObject viene modificato. Ereditato da SqlSmoObject.
Metodo protetto PostCreate Metodo attivato dopo la creazione dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto PostDrop Metodo attivato dopo l'eliminazione dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico Refresh Aggiorna l'oggetto e recupera le proprietà al successivo accesso all'oggetto. Ereditato da SqlSmoObject.
Metodo pubblico Regenerate(String) Regenerates the database master key by using the specified new password.
Metodo pubblico 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.
Metodo protetto ScriptAlter Modifica l'oggetto SqlSmoObject in base ai parametri. Ereditato da SqlSmoObject.
Metodo protetto ScriptCreate Modifica l'oggetto SqlSmoObject in base ai parametri. Ereditato da SqlSmoObject.
Metodo protetto ScriptDdl Genera un oggetto InvalidSmoOperationException. Ereditato da SqlSmoObject.
Metodo protetto ScriptDrop Genera un oggetto InvalidSmoOperationException. Ereditato da SqlSmoObject.
Metodo protetto ScriptImpl() () () () Ottiene una raccolta di script dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ScriptImpl(ScriptingOptions) Ottiene una raccolta di script dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ScriptImplWorker Ottiene una raccolta di script dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto SetParentImpl Imposta l'elemento padre dell'oggetto SqlSmoObject sul parametro newParent. Ereditato da SqlSmoObject.
Metodo pubblico ToString Restituisce un oggetto String che rappresenta l'oggetto a cui si fa riferimento. Ereditato da SqlSmoObject.
Metodo protetto TouchImpl Non implementato. Ereditato da SqlSmoObject.
Metodo protetto UnbindDefaultImpl Annulla l'associazione delle colonne predefinite dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto UnbindRuleImpl Annulla l'associazione delle regole dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico Validate Validates the state of an object. Ereditato da SmoObjectBase.

In alto

Eventi

  Nome Descrizione
Evento pubblico PropertyChanged Rappresenta l'evento che si verifica quando viene modificata una proprietà. Ereditato da SqlSmoObject.
Evento pubblico PropertyMetadataChanged Rappresenta l'evento che si verifica quando vengono modificati i metadati di una proprietà. Ereditato da SqlSmoObject.

In alto

Campi

  Nome Descrizione
Campo protetto m_ExtendedProperties Rappresenta una proprietà definita per estendere le proprietà fornite da un oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Campo protetto singletonParent Rappresenta il padre singleton. Ereditato da SqlSmoObject.

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .Discover Individua eventuali dipendenze. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetDomainRoot Restituisce la radice del dominio. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetParent Ottiene l'elemento padre di questo oggetto. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetPropertyType Ottiene il tipo della proprietà specificata. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetPropertyValue Ottiene il valore della proprietà specificata. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetUrn Ottiene l'URN (Unified Resource Name) dell'oggetto. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .Resolve Ottiene l'istanza che contiene le informazioni sull'oggetto dall'URN (Unified Resource Name) dell'oggetto. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .SetObjectState Imposta lo stato dell'oggetto sul valore SfcObjectState specificato. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .SetPropertyValue Imposta il valore della proprietà. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato ISfcPropertyProvider. . :: . .GetPropertySet Ottiene il riferimento di interfaccia al set di proprietà di questo oggetto. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaProprietà privata ISfcSupportsDesignMode. . :: . .IsDesignMode Gets a Boolean value that indicates whether the object supports design mode. Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

In alto

Osservazioni

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.

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.