Table.ChangeSchema(String) Table.ChangeSchema(String) Table.ChangeSchema(String) Method

Definition

Changes the schema on the referenced table.

public:
 void ChangeSchema(System::String ^ newSchema);
public void ChangeSchema (string newSchema);
Public Sub ChangeSchema (newSchema As String)
Parameters
newSchema
String String String

A String value that specifies the new schema.

Examples

The following code example shows how to change the schema of a table.

C#

Server srv = new Server("(local)");  
Database db = srv.Databases["AdventureWorks2012"];  

Table tb = new Table(db, "Test Table");  
Column col1 = new Column(tb, "Name", DataType.NChar(50));  
Column col2 = new Column(tb, "ID", DataType.Int);  

tb.Columns.Add(col1);   
tb.Columns.Add(col2);   
tb.Create();  
tb.ChangeSchema("Person");  

Powershell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$db = New-Object Microsoft.SqlServer.Management.Smo.Database  
$db = $srv.Databases.Item("AdventureWorks2012")  

$tb = new-object Microsoft.SqlServer.Management.Smo.Table($db, "Test Table")  
$col1 = new-object Microsoft.SqlServer.Management.Smo.Column($tb, "Name", [Microsoft.SqlServer.Management.Smo.DataType]::NChar(50))  
$col2 = new-object Microsoft.SqlServer.Management.Smo.Column($tb, "ID", [Microsoft.SqlServer.Management.Smo.DataType]::Int)  
$tb.Columns.Add($col1)  
$tb.Columns.Add($col2)  
$tb.Create()  
$tb.ChangeSchema("Person")  

Remarks

The table must be created using the Create method before the schema can be changed.

Applies to