DataColumnCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Crea e aggiunge un oggetto DataColumn all'insieme DataColumnCollection.

Overload

Add()	Crea e aggiunge un oggetto DataColumn all'insieme DataColumnCollection.
Add(DataColumn)	Crea e aggiunge l'oggetto DataColumn specificato all'insieme DataColumnCollection.
Add(String)	Crea e aggiunge un oggetto DataColumn con il nome specificato alla classe DataColumnCollection.
Add(String, Type)	Crea e aggiunge un oggetto DataColumn con il nome e il tipo specificati alla classe DataColumnCollection.
Add(String, Type, String)	Crea e aggiunge un oggetto DataColumn con il nome, il tipo e l'espressione specificati alla classe DataColumnCollection.

Add()

Source:

DataColumnCollection.cs

Crea e aggiunge un oggetto DataColumn all'insieme DataColumnCollection.

public:
 System::Data::DataColumn ^ Add();

public System.Data.DataColumn Add ();

member this.Add : unit -> System.Data.DataColumn

Public Function Add () As DataColumn

Restituisce

DataColumn

Oggetto DataColumn appena creato.

Esempio

Nell'esempio seguente viene creato e aggiunto un nuovo DataColumn oggetto all'oggetto DataColumnCollection di un oggetto DataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add()

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "Total"
       .Expression = "UnitPrice * Quantity"
       .ReadOnly = True
       .Unique = False
    End With
End Sub

Commenti

Alla colonna viene assegnato un nome predefinito ("Column1", "Column2" e così via).

Se la raccolta viene modificata aggiungendo o rimuovendo colonne, l'evento CollectionChanged si verifica.

Vedi anche

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Source:

DataColumnCollection.cs

Crea e aggiunge l'oggetto DataColumn specificato all'insieme DataColumnCollection.

public:
 void Add(System::Data::DataColumn ^ column);

public void Add (System.Data.DataColumn column);

member this.Add : System.Data.DataColumn -> unit

Public Sub Add (column As DataColumn)

Parametri

column

DataColumn

Oggetto DataColumn da aggiungere.

Eccezioni

ArgumentNullException

Il valore del parametro column è null.

ArgumentException

La colonna appartiene già a questo insieme o a un altro insieme.

DuplicateNameException

L'insieme contiene già una colonna con il nome specificato. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

InvalidExpressionException

Espressione non valida. Per ulteriori informazioni sulla creazione di espressioni, vedere la proprietà Expression.

Esempio

Nell'esempio seguente viene aggiunto un DataColumn oggetto a un oggetto DataColumnCollection.

Private Sub AddDataColumn()
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    Dim column As New DataColumn()
    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "ItemPrice"
       .Caption = "Price"
       .ReadOnly = False
       .Unique = False
       .DefaultValue = 0
    End With
    columns.Add(column)
End Sub

Commenti

Se la raccolta viene modificata aggiungendo o rimuovendo colonne, l'evento CollectionChanged si verifica.

Vedi anche

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

Source:

DataColumnCollection.cs

Crea e aggiunge un oggetto DataColumn con il nome specificato alla classe DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);

public System.Data.DataColumn Add (string? columnName);

member this.Add : string -> System.Data.DataColumn

Public Function Add (columnName As String) As DataColumn

Parametri

columnName

String

Nome della colonna.

Restituisce

DataColumn

Oggetto DataColumn appena creato.

Eccezioni

DuplicateNameException

L'insieme contiene già una colonna con il nome specificato. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

Esempio

Nell'esempio seguente viene creato e aggiunto un nuovo DataColumn oggetto a di DataColumnCollection un oggetto DataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add("Total")

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
End Sub

Commenti

Per impostazione predefinita, per DataType la nuova colonna è string.

Se null o una stringa vuota ("") viene passata per il nome, alla colonna viene assegnato un nome predefinito ("Column1", "Column2" e così via).

Utilizzare il Contains metodo per determinare se una colonna con il nome proposto esiste già nella raccolta.

Se la raccolta viene modificata aggiungendo o rimuovendo colonne, l'evento CollectionChanged si verifica.

Vedi anche

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Source:

DataColumnCollection.cs

Crea e aggiunge un oggetto DataColumn con il nome e il tipo specificati alla classe DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public System.Data.DataColumn Add (string? columnName, Type type);

member this.Add : string * Type -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

Parametri

columnName

String

Proprietà ColumnName da utilizzare nella creazione della colonna.

type

Type

Proprietà DataType della nuova colonna.

Restituisce

DataColumn

Oggetto DataColumn appena creato.

Eccezioni

DuplicateNameException

L'insieme contiene già una colonna con il nome specificato. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

InvalidExpressionException

Espressione non valida. Per ulteriori informazioni sulla creazione di espressioni, vedere la proprietà Expression.

Esempio

Nell'esempio seguente viene creato e aggiunto un nuovo DataColumn oggetto a di DataColumnCollection un oggetto DataTable.

Private Sub AddColumn()
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    ' Add a new column and return it.
    Dim column As DataColumn = columns.Add( _
        "Total", System.Type.GetType("System.Decimal"))
    column.ReadOnly = True
    column.Unique = False
End Sub

Commenti

Se null o una stringa vuota ("") viene passata per il nome, alla colonna viene assegnato un nome predefinito ("Column1", "Column2" e così via).

Utilizzare il Contains metodo per determinare se una colonna con il nome proposto esiste già nella raccolta.

Se la raccolta viene modificata aggiungendo o rimuovendo colonne, l'evento CollectionChanged si verifica.

Vedi anche

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Source:

DataColumnCollection.cs

Crea e aggiunge un oggetto DataColumn con il nome, il tipo e l'espressione specificati alla classe DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public System.Data.DataColumn Add (string? columnName, Type type, string expression);

member this.Add : string * Type * string -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

Parametri

columnName

String

Nome da utilizzare nella creazione della colonna.

type

Type

Proprietà DataType della nuova colonna.

expression

String

Espressione da assegnare alla proprietà Expression.

Restituisce

DataColumn

Oggetto DataColumn appena creato.

Eccezioni

DuplicateNameException

L'insieme contiene già una colonna con il nome specificato. Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

InvalidExpressionException

Espressione non valida. Per ulteriori informazioni sulla creazione di espressioni, vedere la proprietà Expression.

Esempio

Nell'esempio seguente viene creato e aggiunto un nuovo DataColumn oggetto a di DataColumnCollection un oggetto DataTable.

Private Sub AddColumn()
    ' Get the DataColumnCollection of a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    ' Add a new column and return it.
    Dim column As DataColumn = _
        columns.Add("Total", System.Type.GetType( _
        "System.Decimal"), "Price + Tax")
    column.ReadOnly = True
    column.Unique = False
 End Sub

Commenti

Se null o una stringa vuota ("") viene passata per il nome, alla colonna viene assegnato un nome predefinito ("Column1", "Column2" e così via).

Utilizzare il Contains metodo per determinare se una colonna con il nome proposto esiste già nella raccolta.

Se la raccolta viene modificata aggiungendo o rimuovendo colonne, l'evento CollectionChanged si verifica.

Vedi anche

• ColumnName
• Contains(String)
• DataType
• Expression