Chamando métodosCalling Methods

ESTE TÓPICO APLICA-SE AO: simSQL ServersimBanco de Dados SQL do AzuresimSQL Data Warehouse do Azure nãoParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL ServeryesAzure SQL DatabaseyesAzure SQL Data Warehouse noParallel Data Warehouse

Os métodos executam tarefas específicas relacionadas ao objeto, como emitir uma ponto de verificação em um banco de dados ou solicitar uma lista enumerada de logons para a instância do MicrosoftMicrosoft SQL ServerSQL Server.Methods perform specific tasks related to the object, such as issuing a Checkpoint on a database or requesting an enumerated list of logons for the instance of MicrosoftMicrosoft SQL ServerSQL Server.

Os métodos executam uma operação em um objeto.Methods perform an operation on an object. Podem assumir parâmetros e frequentemente têm um valor de retorno.Methods can take parameters and often have a return value. O valor de retorno pode ser um tipo de dados simples, um objeto complexo ou uma estrutura que contém muitos membros.The return value can be a simple data type, a complex object, or a structure that contains many members.

Use o tratamento de exceções para detectar se o método obteve êxito.Use exception handling to detect whether the method has been successful. Para obter mais informações, consulte Handling SMO Exceptions.For more information, see Handling SMO Exceptions.

ExemplosExamples

Para usar qualquer exemplo de código fornecido, será necessário escolher o ambiente de programação, o modelo de programação e a linguagem de programação para criar o aplicativo.To use any code example that is provided, you will have to choose the programming environment, the programming template, and the programming language in which to create your application. Para obter mais informações, consulte criar um Visual C# projeto SMO no Visual Studio .NET.For more information, see Create a Visual C# SMO Project in Visual Studio .NET.

Usando um método SMO simples no Visual BasicUsing a Simple SMO Method in Visual Basic

Neste exemplo, o método Create não utiliza nenhum parâmetro e não tem nenhum valor de retorno.In this example, the Create method takes no parameters and has no return value.

'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()

Usando um método SMO simples no Visual C#Using a Simple SMO Method in Visual C#

Neste exemplo, o método Create não utiliza nenhum parâmetro e não tem nenhum valor de retorno.In this example, the Create method takes no parameters and has no return value.

{   
//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();   

}}

Usando um método SMO com um parâmetro no Visual BasicUsing an SMO Method with a Parameter in Visual Basic

O Table objeto tem um método chamado RebuildIndexes.The Table object has a method called RebuildIndexes. Esse método exige um parâmetro numérico que especifica o FillFactor.This method requires a numeric parameter that specifies the FillFactor.

Dim srv As Server  
srv = New Server  
Dim tb As Table  
tb = srv.Databases("AdventureWorks2012").Tables("Employee", "HumanResources")  
tb.RebuildIndexes(70)  

Usando um método SMO com um parâmetro no Visual C#Using an SMO Method with a Parameter in Visual C#

O Table objeto tem um método chamado RebuildIndexes.The Table object has a method called RebuildIndexes. Esse método exige um parâmetro numérico que especifica o FillFactor.This method requires a numeric parameter that specifies the FillFactor.

{   
Server srv = default(Server);   
srv = new Server();   
Table tb = default(Table);   
tb = srv.Databases("AdventureWorks2012").Tables("Employee", "HumanResources");   
tb.RebuildIndexes(70);   
}   

Usando um método de enumeração que retorna um objeto DataTable no Visual BasicUsing an Enumeration Method that Returns a DataTable Object in Visual Basic

Esta seção descreve como chamar um método de enumeração e como tratar os dados no retornado DataTable objeto.This section describes how to call an enumeration method and how to handle the data in the returned DataTable object.

O método EnumCollations retorna um objeto DataTable, que exige navegação adicional para acessar todas as informações de agrupamento disponíveis sobre a instância do SQL ServerSQL Server.The EnumCollations method returns a DataTable object, which requires further navigation to access all available collation information about the instance of SQL ServerSQL 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  

Usando um método de enumeração que retorna um objeto DataTable no Visual C#Using an Enumeration Method that Returns a DataTable Object in Visual C#

Esta seção descreve como chamar um método de enumeração e como tratar os dados no retornado DataTable objeto.This section describes how to call an enumeration method and how to handle the data in the returned DataTable object.

O EnumCollations método retorna um sistema DataTable objeto.The EnumCollations method returns a system DataTable object. O DataTable objeto exige navegação adicional para acessar todas as informações de agrupamento disponíveis sobre a instância do SQL ServerSQL Server.The DataTable object requires further navigation to access all available collation information about the instance of SQL ServerSQL 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);   
  }   
}   
}   

Construindo um objeto no Visual BasicConstructing an Object in Visual Basic

O construtor de qualquer objeto pode ser chamado usando o operador New .The constructor of any object can be called by using the New operator. O construtor do objeto Database é sobrecarregado e a versão do construtor do objeto Database que é usada no exemplo utiliza dois parâmetros: o objeto Server pai ao qual o banco de dados pertence e uma cadeia de caracteres que representa o nome do novo banco de dados.The Database object constructor is overloaded and the version of the Database object constructor that is used in the sample takes two parameters: the parent Server object to which the database belongs, and a string that represents the name of the new database.

'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)

Construindo um objeto no Visual C#Constructing an Object in Visual C#

O construtor de qualquer objeto pode ser chamado usando o operador New .The constructor of any object can be called by using the New operator. O construtor do objeto Database é sobrecarregado e a versão do construtor do objeto Database que é usada no exemplo utiliza dois parâmetros: o objeto Server pai ao qual o banco de dados pertence e uma cadeia de caracteres que representa o nome do novo banco de dados.The Database object constructor is overloaded and the version of the Database object constructor that is used in the sample takes two parameters: the parent Server object to which the database belongs, and a string that represents the name of the new database.

{   
Server srv;   
srv = new Server();   
Table tb;   
tb = srv.Databases("AdventureWorks2012").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);   
}  

Copiando um objeto SMO no Visual BasicCopying an SMO Object in Visual Basic

Este exemplo de código usa o Copy método para criar uma cópia do Server objeto.This code example uses the Copy method to create a copy of the Server object. O Server objeto representa uma conexão a uma instância de SQL ServerSQL Server.The Server object represents a connection to an instance of SQL ServerSQL 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 = "AdventureWorks2012"
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)

Copiando um objeto SMO no Visual C#Copying an SMO Object in Visual C#

Este exemplo de código usa o Copy método para criar uma cópia do Server objeto.This code example uses the Copy method to create a copy of the Server object. O Server objeto representa uma conexão a uma instância de SQL ServerSQL Server.The Server object represents a connection to an instance of SQL ServerSQL 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 = "AdventureWorks2012";   
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);   
}  

Monitorando processos de servidor no Visual BasicMonitoring Server Processes in Visual Basic

Você pode obter as informações de tipo de status atuais sobre a instância de SQL ServerSQL Server por meio de métodos de enumeração.You can obtain the current status type information about the instance of SQL ServerSQL Server through enumeration methods. O exemplo de código usa o método EnumProcesses para descobrir informações sobre os processos atuais.The code example uses the EnumProcesses method to discover information about the current processes. Ele também demonstra como trabalhar com as colunas e linhas no objeto DataTable retornado.It also demonstrates how to work with the columns and rows in the returned DataTable object.

'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

Monitorando processos de servidor no Visual C#Monitoring Server Processes in Visual C#

Você pode obter as informações de tipo de status atuais sobre a instância de SQL ServerSQL Server por meio de métodos de enumeração.You can obtain the current status type information about the instance of SQL ServerSQL Server through enumeration methods. O exemplo de código usa o método EnumProcesses para descobrir informações sobre os processos atuais.The code example uses the EnumProcesses method to discover information about the current processes. Ele também demonstra como trabalhar com as colunas e linhas no objeto DataTable retornado.It also demonstrates how to work with the columns and rows in the returned DataTable object.

//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);   
  }   
}   
}   

Consulte tambémSee Also

Server
ServerConnection