DataGridViewCell.Value DataGridViewCell.Value DataGridViewCell.Value DataGridViewCell.Value Property

Definition

Ruft den dieser Zelle zugeordneten Wert ab oder legt ihn fest.Gets or sets the value associated with this cell.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Browsable(false)]
public object Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

Eigenschaftswert

Ruft die von der Zelle anzuzeigenden Daten ab oder legt sie fest.Gets or sets the data to be displayed by the cell. Die Standardeinstellung ist null.The default is null.

Ausnahmen

RowIndex liegt außerhalb des gültigen Bereichs von 0 (null) bis zur Anzahl der Zeilen im Steuerelement minus 1.RowIndex is outside the valid range of 0 to the number of rows in the control minus 1.

ColumnIndex ist kleiner als 0 (null). Das bedeutet, dass die Zelle eine Zeilenheaderzelle darstellt.ColumnIndex is less than 0, indicating that the cell is a row header cell.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie der Inhalt einer Zelle mit der Value -Eigenschaft aktualisiert wird.The following code example shows how to update a cell's contents with the Value property. Dieses Beispiel ist Teil eines größeren Code Beispiels, das unter Vorgehensweise: Bearbeiten Sie Zeilen im Windows Forms DataGridView-Steuerelement.This example is part of a larger code example provided in How to: Manipulate Rows in the Windows Forms DataGridView Control.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
void UpdateStars( DataGridViewRow^ row, String^ stars )
{
   row->Cells[ ratingColumn ]->Value = stars;
   
   // Resize the column width to account for the new value.
   row->DataGridView->AutoResizeColumn( ratingColumn, DataGridViewAutoSizeColumnMode::DisplayedCells );
}


// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row, string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}
' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer = 3

Private Sub UpdateStars(ByVal row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

Hinweise

Wenn Sie einer Zelle einen anderen Wert zuweisen, wird das CellValueChanged -Ereignis DataGridView des-Steuer Elements ausgelöst.When you assign a different value to a cell, the CellValueChanged event of the DataGridView control is raised.

Die Value -Eigenschaft ist das tatsächliche Datenobjekt, das in der Zelle enthalten FormattedValue ist, während die-Eigenschaft die formatierte Darstellung der Daten darstellt.The Value property is the actual data object contained by the cell, whereas the FormattedValue property is the formatted representation of the data. Die ValueType - FormattedValueType Eigenschaft und die-Eigenschaft entsprechen den Datentypen dieser Werte.The ValueType and FormattedValueType properties correspond to the data types of these values, respectively.

Wenn Sie die Value -Eigenschaft festlegen, wird der angegebene Wert nicht automatisch von einem formatierten anzeigen Wert in einen zugrunde liegenden Zellwert konvertiert.When you set the Value property, the specified value is not automatically converted from a formatted, display value to an underlying cell value. Beispielsweise wird der DataGridViewCellStyle für die Zelle tatsächlich ignoriert, sodass das Festlegen Value von auf DataGridViewCellStyle.NullValue nicht zu einem Eigenschafts Wert von DataGridViewCellStyle.DataSourceNullValueführt.For example, the DataGridViewCellStyle in effect for the cell is ignored, so setting Value to DataGridViewCellStyle.NullValue does not result in a property value of DataGridViewCellStyle.DataSourceNullValue.

Gilt für:

Siehe auch