• Article

Classe Transfer

The Transfer object is a tool object that provides programmatic control over copying of schemas and data to other instances of SQL Server.

Hiérarchie d'héritage

System. . :: . .Object
  Microsoft.SqlServer.Management.Smo..::..Transfer

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

Syntaxe

'Déclaration
Public Class Transfer _
    Implements ITransferMetadataProvider
'Utilisation
Dim instance As Transfer

public class Transfer : ITransferMetadataProvider

public ref class Transfer : ITransferMetadataProvider

type Transfer =  
    class
        interface ITransferMetadataProvider
    end

public class Transfer implements ITransferMetadataProvider

Le type Transfer expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique Transfer() () () () Initializes a new instance of the Transfer class.
Méthode publique Transfer(Database) Initializes a new instance of the Transfer class that uses the specified database as the source of the transfer operation.

Haut de la page

Propriétés

  Nom Description
Propriété publique CopyAllDatabaseTriggers Gets or sets the Boolean property value that specifies whether all the SQL Server database triggers are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllDefaults Gets or sets the Boolean property value that specifies whether all the SQL Server defaults are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllFullTextCatalogs Gets or sets the Boolean property value that specifies whether all the SQL Server Full-Text catalogs are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllFullTextStopLists Gets or sets the Boolean property value that specifies whether all the SQL Server full-text stop lists are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllLogins Gets or sets the Boolean property value that specifies whether all the SQL Server logins are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllObjects Gets or sets the Boolean property value that specifies whether all the SQL Server objects are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllPartitionFunctions Gets or sets the Boolean property value that specifies whether all the SQL Server partition functions are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllPartitionSchemes Gets or sets the Boolean property value that specifies whether all the SQL Server partition schemes are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllPlanGuides Gets or sets the Boolean property value that specifies whether all the SQL Server plan guides are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllRoles Gets or sets the Boolean property value that specifies whether all the SQL Server roles are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllRules Gets or sets the Boolean property value that specifies whether all the SQL Server rules are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllSchemas Gets or sets the Boolean property value that specifies whether all the SQL Server schemas are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllSqlAssemblies Gets or sets the Boolean property value that specifies whether all the SQL Server assemblies are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllStoredProcedures Gets or sets the Boolean property value that specifies whether all the SQL Server stored procedures are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllSynonyms Gets or sets the Boolean property value that specifies whether all the SQL Server synonyms are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllTables Gets or sets the Boolean property value that specifies whether all the SQL Server tables are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllUserDefinedAggregates Gets or sets the Boolean property value that specifies whether all the SQL Server user-defined aggregates are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllUserDefinedDataTypes Gets or sets the Boolean property value that specifies whether all the SQL Server user-defined data types are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllUserDefinedFunctions Gets or sets the Boolean property value that specifies whether all the SQL Server user-defined functions are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllUserDefinedTableTypes Gets or sets the Boolean property value that specifies whether all the SQL Server user-defined table types are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllUserDefinedTypes Gets or sets the Boolean property value that specifies whether all the SQL Server user-defined types are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllUsers Gets or sets the Boolean property value that specifies whether all the SQL Server database users are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllViews Gets or sets the Boolean property value that specifies whether all the SQL Server views are copied from the source database to the target database in the transfer operation.
Propriété publique CopyAllXmlSchemaCollections Gets or sets the Boolean property value that specifies whether all the SQL Server XML schema collections are copied from the source database to the target database in the transfer operation.
Propriété publique CopyData Gets or sets the Boolean property value that specifies whether all the data is copied from the source database to the target database in the transfer operation.
Propriété publique CopySchema Gets or sets the Boolean property value that specifies whether the schema is copied from the source database to the target database in the transfer operation.
Propriété publique CreateTargetDatabase Gets or sets the Boolean property value that specifies whether the target database is created in the transfer operation.
Propriété publique Database Gets or sets the database from which schema or data is to be transferred to the target location.
Propriété publique DatabaseFileMappings Gets or sets properties that are associated with flat file destination based on a DatabaseFileMappingsDictionary object.
Propriété publique DestinationDatabase Gets or sets the database that is the destination of the transfer operation.
Propriété publique DestinationLogin Gets or sets the logon for the instance of SQL Server to which the destination database belongs.
Propriété publique DestinationLoginSecure Gets or sets the Boolean property that specifies whether the instance of SQL Server that contains the destination database is enabled for Windows Authentication or not.
Propriété publique DestinationPassword Gets or sets the logon password for the instance of SQL Server to which the destination database belongs.
Propriété publique DestinationServer Gets or sets the instance of SQL Server that owns the database that is the destination of the transfer operation.
Propriété publique DestinationTranslateChar Gets or sets the Boolean property value that specifies whether the transfer operation translates the code page for characters on the destination database.
Propriété publique DropDestinationObjectsFirst Gets or sets the Boolean property value that specifies whether to drop the objects in the destination database before the transfer operation.
Propriété publique ObjectList Gets or sets the objects copied from the source to destination in the transfer operation.
Propriété publique Options Gets or sets the options for the transfer operation.
Propriété publique PrefetchObjects Gets or sets the Boolean property that specifies whether to prefetch the objects before the transfer operation.
Propriété publique PreserveDbo Gets or sets a Boolean value that specifies whether DBO ownerships are retained through the transfer process.
Propriété publique PreserveLogins Gets or sets the Boolean property that specifies whether to preserve logins in the transfer operation.
Propriété publique SourceTranslateChar Gets or sets the Boolean property value that specifies whether the transfer operation translates the code page for characters on the source database.
Propriété publique TargetDatabaseFilePath Gets or sets the path to where the database files will be copied.
Propriété publique TargetLogFilePath Gets or sets the path to where the database files will be copied.
Propriété publique TemporaryPackageDirectory Gets or sets the file location for storage of temporary packages created during the transfer operation.
Propriété publique UseDestinationTransaction Gets or sets the Boolean property value that specifies whether to use the destination transaction.

Haut de la page

Méthodes

  Nom Description
Méthode publique EnumObjects Returns an enumerated list of Uniform Resource Name (URN) values that represent the objects included in the transfer operation.
Méthode publique EnumScriptTransfer Creates a Transact-SQL command batch script used to transfer database objects or database objects and data to another database instance.
Méthode publique Equals (hérité de Object.)
Méthode protégée Finalize (hérité de Object.)
Méthode publique GetHashCode (hérité de Object.)
Méthode publique GetTransferProvider Returns the data transfer provider interface.
Méthode publique GetType (hérité de Object.)
Méthode protégée MemberwiseClone (hérité de Object.)
Méthode protégéeMembre statique ProcessDependencyChain Returns a URN array with options.
Méthode publique ScriptTransfer Creates a Transact-SQL command batch script that creates database objects that are transferred by the transfer operation.
Méthode publique ToString (hérité de Object.)
Méthode publique TransferData Transfers data as specified by the Transfer object.

Haut de la page

Événements

  Nom Description
Événement public DataTransferEvent Reports that data has been transferred.
Événement public DiscoveryProgress Marks the progress of the discovery process.
Événement public ScriptingError Reports that an error occurred during the scripting process.
Événement public ScriptingProgress Marks the progress of the scripting process.

Haut de la page

Implémentations d'interfaces explicites

  Nom Description
Implémentation d'interface expliciteMéthode privée ITransferMetadataProvider. . :: . .GetOptions The ITransferMetadataProvider class represents an interface that implements the transfer metadata process on the referenced connection.
Implémentation d'interface expliciteMéthode privée ITransferMetadataProvider. . :: . .SaveMetadata Saves metadata when transferring databases across instances.

Haut de la page

Notes

There are some limitations when transferring a database to a server instance that is running SQL Server 2000: 

  • If the database has a schema for which there is no corresponding user on the target SQL Server 2000 server instance, it cannot be transferred. In this case, you have to create a user who has a name that is the same as the name of the schema.

  • Any object that uses the following data types cannot be transferred:

    • SqlDataType.Xml

    • SqlDataType.VarCharMax

    • SqlDataType.NVarCharMax

    • SqlDataType.VarBinaryMax

The following object types cannot be transferred:

  • All broker objects

  • All mail objects

  • Endpoint

  • ServerDdlTrigger

  • ExtendedStoredProcedure

  • FullTextCatalog

  • UserDefinedMessage

  • ApplicationRole

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

To transfer data, users can be a member of the public fixed server role.

Thread Safety

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type est sûr dans le cadre des opérations à plusieurs threads. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe. 

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.