Share via


DataFile Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The DataFile property specifies the operating system name of the primary file implementing the referenced Microsoft SQL Server replication distribution database.

Syntax

object
.DataFile [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list
  • value
    A string that identifies an operating system file by name

Data Type

String

Modifiable

Read/write if the DistributionDatabase object is used to create a replication distribution database. Read-only if a DistributionDatabase object references an existing SQL Server database.

Prototype (C/C++)

HRESULT GetDataFile(SQLDMO_LPBSTR pRetVal);
HRESULT SetDataFile(SQLDMO_LPCSTR NewValue);

Note

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Remarks

Data storage for a SQL Server database is implemented in one or more operating system files. One operating system file maintains database-specific system table data and is identified as the primary database file.

When using the DistributionDatabase object to create a replication distribution database, fully specify an operating system file by setting the DataFolder and DataFile properties.

Applies To:

DistributionDatabase Object

See Also

Reference

DataFolder Property

Help and Information

Getting SQL Server 2005 Assistance