Llamar a métodos
Se aplica a:
SQL ServerAzure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics
Los métodos realizan tareas específicas relacionadas con el objeto, como emitir un punto de control en una base de datos o solicitar una lista enumerada de inicios de sesión para la instancia de Microsoft SQL Server.
Los métodos realizan una operación en un objeto. Los métodos pueden tomar parámetros y a menudo tener un valor devuelto. El valor devuelto puede ser un tipo de datos simple, un objeto complejo o una estructura que contiene muchos miembros.
Use el control de excepciones para detectar si el método se realizó correctamente. Para más información, consulte Handling SMO Exceptions.
Ejemplos
Para utilizar cualquier ejemplo de código que se proporcione, deberá elegir el entorno de programación, la plantilla de programación y el lenguaje de programación con los que crear su aplicación. Para obtener más información, vea Creación de un proyecto SMO de Visual C# en Visual Studio .NET.
Usar un método SMO simple en Visual Basic
En este ejemplo, el método Create no toma ningún parámetro y no devuelve ningún valor.
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Define a Database object variable by supplying the parent server and the database name arguments in the constructor.
Dim db As Database
db = New Database(srv, "Test_SMO_Database")
'Call the Create method to create the database on the instance of SQL Server.
db.Create()
Usar un método SMO simple en Visual C#
En este ejemplo, el método Create no toma ningún parámetro y no devuelve ningún valor.
{
//Connect to the local, default instance of SQL Server.
Server srv;
srv = new Server();
//Define a Database object variable by supplying the parent server and the database name arguments in the constructor.
Database db;
db = new Database(srv, "Test_SMO_Database");
//Call the Create method to create the database on the instance of SQL Server.
db.Create();
}
Usar un método SMO con un parámetro en Visual Basic
El objeto Table tiene un método denominado RebuildIndexes. Este método requiere un parámetro numérico que especifica FillFactor.
Dim srv As Server
srv = New Server
Dim tb As Table
tb = srv.Databases("AdventureWorks2022").Tables("Employee", "HumanResources")
tb.RebuildIndexes(70)
Usar un método SMO con un parámetro en Visual C#
El objeto Table tiene un método denominado RebuildIndexes. Este método requiere un parámetro numérico que especifica FillFactor.
{
Server srv = default(Server);
srv = new Server();
Table tb = default(Table);
tb = srv.Databases("AdventureWorks2022").Tables("Employee", "HumanResources");
tb.RebuildIndexes(70);
}
Usar un método de enumeración que devuelve un objeto DataTable en Visual Basic
En esta sección se describe cómo llamar a un método de enumeración y cómo controlar los datos del objeto DataTable devuelto.
El EnumCollations método devuelve un DataTable objeto , que requiere una navegación adicional para tener acceso a toda la información de intercalación disponible sobre la instancia de SQL Server.
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Call the EnumCollations method and return collation information to DataTable variable.
Dim d As DataTable
'Select the returned data into an array of DataRow.
d = srv.EnumCollations
'Iterate through the rows and display collation details for the instance of SQL Server.
Dim r As DataRow
Dim c As DataColumn
For Each r In d.Rows
Console.WriteLine("==")
For Each c In r.Table.Columns
Console.WriteLine(c.ColumnName + " = " + r(c).ToString)
Next
Next
Usar un método de enumeración que devuelve un objeto DataTable en Visual C#
En esta sección se describe cómo llamar a un método de enumeración y cómo controlar los datos del objeto DataTable devuelto.
El método EnumCollations devuelve un objeto DataTable del sistema. El DataTable objeto requiere más navegación para acceder a toda la información de intercalación disponible sobre la instancia de SQL Server.
//Connect to the local, default instance of SQL Server.
{
Server srv = default(Server);
srv = new Server();
//Call the EnumCollations method and return collation information to DataTable variable.
DataTable d = default(DataTable);
//Select the returned data into an array of DataRow.
d = srv.EnumCollations;
//Iterate through the rows and display collation details for the instance of SQL Server.
DataRow r = default(DataRow);
DataColumn c = default(DataColumn);
foreach ( r in d.Rows) {
Console.WriteLine("=========");
foreach ( c in r.Table.Columns) {
Console.WriteLine(c.ColumnName + " = " + r(c).ToString);
}
}
}
Construir un objeto en Visual Basic
Se puede llamar al constructor de cualquier objeto mediante el operador New . El constructor de objeto Database se sobrecarga y la versión del constructor de objeto Database que se usa en el ejemplo toma dos parámetros: el objeto primario Server al que pertenece la base de datos y una cadena que representa el nombre de la nueva base de datos.
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Declare and define a Database object by supplying the parent server and the database name arguments in the constructor.
Dim d As Database
d = New Database(srv, "Test_SMO_Database")
'Create the database on the instance of SQL Server.
d.Create()
Console.WriteLine(d.Name)
Construir un objeto en Visual C#
Se puede llamar al constructor de cualquier objeto mediante el operador New . El constructor de objeto Database se sobrecarga y la versión del constructor de objeto Database que se usa en el ejemplo toma dos parámetros: el objeto primario Server al que pertenece la base de datos y una cadena que representa el nombre de la nueva base de datos.
{
Server srv;
srv = new Server();
Table tb;
tb = srv.Databases("AdventureWorks2022").Tables("Employee", "HumanResources");
tb.RebuildIndexes(70);
//Connect to the local, default instance of SQL Server.
Server srv;
srv = new Server();
//Declare and define a Database object by supplying the parent server and the database name arguments in the constructor.
Database d;
d = new Database(srv, "Test_SMO_Database");
//Create the database on the instance of SQL Server.
d.Create();
Console.WriteLine(d.Name);
}
Copiar un objeto SMO en Visual Basic
En este ejemplo de código se usa el método Copy para crear una copia del objeto Server. El Server objeto representa una conexión a una instancia de SQL Server.
'Connect to the local, default instance of SQL Server.
Dim srv1 As Server
srv1 = New Server()
'Modify the default database and the timeout period for the connection.
srv1.ConnectionContext.DatabaseName = "AdventureWorks2022"
srv1.ConnectionContext.ConnectTimeout = 30
'Make a second connection using a copy of the ConnectionContext property and verify settings.
Dim srv2 As Server
srv2 = New Server(srv1.ConnectionContext.Copy)
Console.WriteLine(srv2.ConnectionContext.ConnectTimeout.ToString)
Copiar un objeto SMO en Visual C#
En este ejemplo de código se usa el método Copy para crear una copia del objeto Server. El Server objeto representa una conexión a una instancia de SQL Server.
{
//Connect to the local, default instance of SQL Server.
Server srv1;
srv1 = new Server();
//Modify the default database and the timeout period for the connection.
srv1.ConnectionContext.DatabaseName = "AdventureWorks2022";
srv1.ConnectionContext.ConnectTimeout = 30;
//Make a second connection using a copy of the ConnectionContext property and verify settings.
Server srv2;
srv2 = new Server(srv1.ConnectionContext.Copy);
Console.WriteLine(srv2.ConnectionContext.ConnectTimeout.ToString);
}
Supervisar los procesos de servidor en Visual Basic
Puede obtener la información del tipo de estado actual sobre la instancia de SQL Server mediante métodos de enumeración. El ejemplo de código usa el método EnumProcesses para detectar información sobre los procesos actuales. También muestra cómo trabajar con las columnas y filas del objeto DataTable devuelto.
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Call the EnumCollations method and return collation information to DataTable variable.
Dim d As DataTable
'Select the returned data into an array of DataRow.
d = srv.EnumProcesses
'Iterate through the rows and display collation details for the instance of SQL Server.
Dim r As DataRow
Dim c As DataColumn
For Each r In d.Rows
Console.WriteLine("============================================")
For Each c In r.Table.Columns
Console.WriteLine(c.ColumnName + " = " + r(c).ToString)
Next
Next
Supervisar los procesos de servidor en Visual C#
Puede obtener la información del tipo de estado actual sobre la instancia de SQL Server mediante métodos de enumeración. El ejemplo de código usa el método EnumProcesses para detectar información sobre los procesos actuales. También muestra cómo trabajar con las columnas y filas del objeto DataTable devuelto.
//Connect to the local, default instance of SQL Server.
{
Server srv = default(Server);
srv = new Server();
//Call the EnumCollations method and return collation information to DataTable variable.
DataTable d = default(DataTable);
//Select the returned data into an array of DataRow.
d = srv.EnumProcesses;
//Iterate through the rows and display collation details for the instance of SQL Server.
DataRow r = default(DataRow);
DataColumn c = default(DataColumn);
foreach ( r in d.Rows) {
Console.WriteLine("=====");
foreach ( c in r.Table.Columns) {
Console.WriteLine(c.ColumnName + " = " + r(c).ToString);
}
}
}