Condividi tramite

DataColumnCollection.Add Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.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
Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs

Crea e aggiunge un oggetto DataColumn all'insieme DataColumnCollection.

public:
 System::Data::DataColumn ^ Add();
public:
 virtual System::Data::DataColumn ^ Add();
public System.Data.DataColumn Add ();
public virtual System.Data.DataColumn Add ();
member this.Add : unit -> System.Data.DataColumn
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Function Add () As DataColumn
Public Overridable 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

Si applica a

Add(DataColumn)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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

Si applica a

Add(String)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public System.Data.DataColumn Add (string? columnName);
public System.Data.DataColumn Add (string columnName);
public virtual System.Data.DataColumn Add (string columnName);
member this.Add : string -> System.Data.DataColumn
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Function Add (columnName As String) As DataColumn
Public Overridable 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

Si applica a

Add(String, Type)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public System.Data.DataColumn Add (string? columnName, Type type);
public System.Data.DataColumn Add (string columnName, Type type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
member this.Add : string * Type -> System.Data.DataColumn
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type) As DataColumn
Public Overridable 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

Si applica a

Add(String, Type, String)

Source:
DataColumnCollection.cs
Source:
DataColumnCollection.cs
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:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public System.Data.DataColumn Add (string? columnName, Type type, string expression);
public System.Data.DataColumn Add (string columnName, Type type, string expression);
public virtual System.Data.DataColumn Add (string columnName, Type type, string expression);
member this.Add : string * Type * string -> System.Data.DataColumn
abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type, expression As String) As DataColumn
Public Overridable 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

Si applica a