DataColumnCollection.Add Metodo

Definizione

Spazio dei nomi:: System.Data

Assembly:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea e aggiunge un DataColumn oggetto all'oggetto DataColumnCollection.

Overload

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

Add()

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Crea e aggiunge un DataColumn oggetto all'oggetto 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

Valori restituiti

DataColumn

Oggetto appena creato DataColumn.

Esempio

Nell'esempio seguente viene creato e aggiunto un nuovo DataColumn oggetto a 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 correttamente aggiungendo o rimuovendo colonne, si verifica l'evento CollectionChanged .

Vedi anche

Si applica a

Add(DataColumn)

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Crea e aggiunge l'oggetto specificato DataColumn all'oggetto 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 column parametro è null.

ArgumentException

La colonna appartiene già a questa raccolta o a un'altra raccolta.

DuplicateNameException

La raccolta contiene già una colonna con il nome specificato. Il confronto non fa distinzione tra maiuscole e minuscole.

InvalidExpressionException

L'espressione non è valida. Per altre informazioni su come creare espressioni, vedere la Expression proprietà .

Esempio

Nell'esempio seguente viene aggiunto un oggetto DataColumn 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 correttamente aggiungendo o rimuovendo colonne, si verifica l'evento CollectionChanged .

Vedi anche

Si applica a

Add(String)

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Crea e aggiunge un DataColumn oggetto con il nome specificato all'oggetto 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.

Valori restituiti

DataColumn

Oggetto appena creato DataColumn.

Eccezioni

DuplicateNameException

La raccolta contiene già una colonna con il nome specificato. Il confronto non fa 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 nella raccolta esiste già una colonna con il nome proposto.

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

Vedi anche

Si applica a

Add(String, Type)

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Crea e aggiunge un DataColumn oggetto con il nome e il tipo specificati a 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

Oggetto ColumnName da utilizzare quando si crea la colonna.

type: Type

Oggetto DataType della nuova colonna.

Valori restituiti

DataColumn

Oggetto appena creato DataColumn.

Eccezioni

DuplicateNameException

La raccolta contiene già una colonna con il nome specificato. Il confronto non fa distinzione tra maiuscole e minuscole.

InvalidExpressionException

L'espressione non è valida. Per altre informazioni su come creare espressioni, vedere la Expression proprietà .

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 nella raccolta esiste già una colonna con il nome proposto.

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

Vedi anche

Si applica a

Add(String, Type, String)

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Origine:: DataColumnCollection.cs

Crea e aggiunge un DataColumn oggetto con il nome, il tipo e l'espressione specificati a 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")]
public System.Data.DataColumn Add(string? columnName, Type type, 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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")>]
member this.Add : string * Type * string -> System.Data.DataColumn

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 quando si crea la colonna.

type: Type

Oggetto DataType della nuova colonna.

expression: String

Espressione da assegnare alla Expression proprietà .

Valori restituiti

DataColumn

Oggetto appena creato DataColumn.

Attributi: RequiresUnreferencedCodeAttribute

Eccezioni

DuplicateNameException

La raccolta contiene già una colonna con il nome specificato. Il confronto non fa distinzione tra maiuscole e minuscole.

InvalidExpressionException

L'espressione non è valida. Per altre informazioni su come creare espressioni, vedere la Expression proprietà .

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 nella raccolta esiste già una colonna con il nome proposto.

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

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?