DataGridViewCell.Value Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den dieser Zelle zugeordneten Wert ab oder legt ihn fest.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public object Value { get; set; }

[System.ComponentModel.Browsable(false)]
public object? Value { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Value : obj with get, set

Public Property Value As Object

Eigenschaftswert

Object

Ruft die von der Zelle anzuzeigenden Daten ab oder legt sie fest. Der Standardwert ist null.

Attribute: BrowsableAttribute

Ausnahmen

ArgumentOutOfRangeException

RowIndex liegt außerhalb des gültigen Bereichs von 0 (null) bis zur Anzahl der Zeilen im Steuerelement minus 1.

InvalidOperationException

ColumnIndex ist kleiner als 0 (null). Das bedeutet, dass die Zelle eine Zeilenheaderzelle darstellt.

Beispiele

Das folgende Codebeispiel zeigt, wie der Inhalt einer Zelle mit der Value -Eigenschaft aktualisiert wird. Dieses Beispiel ist Teil eines größeren Codebeispiels unter Vorgehensweise: Bearbeiten von Zeilen im Windows Forms DataGridView-Steuerelement.

// 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 des DataGridView -Steuerelements ausgelöst.

Die Value -Eigenschaft ist das tatsächliche Datenobjekt, das in der Zelle enthalten ist, während die FormattedValue -Eigenschaft die formatierte Darstellung der Daten ist. Die ValueType Eigenschaften und FormattedValueType entsprechen den Datentypen dieser Werte.

Wenn Sie die Value -Eigenschaft festlegen, wird der angegebene Wert nicht automatisch aus einem formatierten Anzeigewert in einen zugrunde liegenden Zellenwert konvertiert. Beispielsweise wird das DataGridViewCellStyle für die Zelle wirkende ignoriert, sodass die Einstellung Value auf nicht zu DataGridViewCellStyle.NullValue einem Eigenschaftswert von DataGridViewCellStyle.DataSourceNullValueführt.

Gilt für:

Teilen über