DateTimePicker.Value Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o valor de data/hora atribuído ao controle.

public:
 property DateTime Value { DateTime get(); void set(DateTime value); };

[System.ComponentModel.Bindable(true)]
public DateTime Value { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.Value : DateTime with get, set

Public Property Value As DateTime

Valor da propriedade

DateTime

O valor DateTime atribuído ao controle.

Atributos: BindableAttribute

Exceções

ArgumentOutOfRangeException

O valor definido é menor que MinDate ou maior que MaxDate.

Exemplos

O exemplo de código a seguir demonstra como usar a Value propriedade para recuperar o valor de data atual. Primeiro, o exemplo exibe a Value propriedade. Em seguida, o exemplo incrementa a Value propriedade em um dia e exibe o valor da propriedade novamente.

public:
   MyClass()
   {
      // Create a new DateTimePicker
      DateTimePicker^ dateTimePicker1 = gcnew DateTimePicker;
      array<Control^>^ myClassControls = {dateTimePicker1};
      Controls->AddRange( myClassControls );
      MessageBox::Show( dateTimePicker1->Value.ToString() );

      dateTimePicker1->Value = DateTime::Now.AddDays( 1 );
      MessageBox::Show( dateTimePicker1->Value.ToString() );
   }

public MyClass()
{
   // Create a new DateTimePicker
   DateTimePicker dateTimePicker1 = new DateTimePicker();
   Controls.AddRange(new Control[] {dateTimePicker1});
   MessageBox.Show(dateTimePicker1.Value.ToString());

   dateTimePicker1.Value = DateTime.Now.AddDays(1);
   MessageBox.Show(dateTimePicker1.Value.ToString());
}

Public Sub New()
   ' Create a new DateTimePicker
   Dim dateTimePicker1 As New DateTimePicker()
   Controls.AddRange(New Control() {dateTimePicker1})
   MessageBox.Show(dateTimePicker1.Value.ToString())
   
   dateTimePicker1.Value = DateTime.Now.AddDays(1)
   MessageBox.Show(dateTimePicker1.Value.ToString())
End Sub

Comentários

Se a Value propriedade não tiver sido alterada no código ou pelo usuário, ela será definida como a data e a hora atuais (DateTime.Now).

Aplica-se a

Confira também

DateTime