Partager via


AttachDBWithSingleFile Method

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

The AttachDBWithSingleFile method makes a database visible to an instance of Microsoft SQL Server.

Syntaxe

object
.AttachDBWithSingleFile(
DBName
,
DataFile
)
as String

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • DBName
    String that specifies an existing database by name.

  • DataFile
    String that specifies the database PRIMARY data file by operating system (OS) file name.

Returns

A string indicating success or failure

Prototype (C/C++)

HRESULT AttachDBWithSingleFile(SQLDMO_LPCSTR DBName,
SQLDMO_LPCSTR DataFile,
SQLDMO_LPBSTR pResult);

Notes

The AttachDBWithSingleFile method is used when a change to the location of OS files implementing the database must be made visible to an instance of SQL Server.

The DataFile argument specifies a single operating system data file implementing storage for a SQL Server database. The instance of SQL Server creates an OS file for transaction log record maintenance as part of the AttachDBWithSingleFile method processing.

Important

The AttachDBWithSingleFile method only succeeds when storage for a database is implemented within a single operating system file. A file or files implementing storage for database transaction log records are not made visible by the method. For more information about making multifile databases visible to an instance of SQL Server, see AttachDB Method.

Making a database visible to an instance of SQL Server by using the AttachDBWithSingleFile method requires appropriate permissions. The SQL Server login used for SQLServer object connection must be a member of the system-defined role sysadmin.