MonthCalendar.SetSelectionRange(DateTime, DateTime) Método

Definição

Define as datas selecionadas em um controle de calendário mensal com o intervalo de datas especificado.

public:
 void SetSelectionRange(DateTime date1, DateTime date2);
public void SetSelectionRange (DateTime date1, DateTime date2);
member this.SetSelectionRange : DateTime * DateTime -> unit
Public Sub SetSelectionRange (date1 As DateTime, date2 As DateTime)

Parâmetros

date1
DateTime

A data de início do intervalo de seleção.

date2
DateTime

A data de término do intervalo de seleção.

Exceções

date1 é menor que a data mínima permitida para um controle de calendário mensal.

- ou - date1 é maior que a data máxima permitida para um controle de calendário mensal.

- ou - date2 é menor que a data mínima permitida para um controle de calendário mensal.

- ou - date2 é maior que a data máxima permitida para um controle de calendário mensal.

Essa exceção apenas será gerada se MinDate ou MaxDate for definido explicitamente.

Comentários

Usar esse método é funcionalmente equivalente a definir a SelectionRange propriedade. Você pode definir as datas de início e término separadamente definindo a propriedade ou SelectionEnd a SelectionStart propriedade.

Se você definir o date1 parâmetro maior que o date2 parâmetro, ambas as datas serão definidas como o date1 valor.

Observação

Rolar pela exibição do calendário com os botões de navegação quando um intervalo é selecionado pode causar resultados inesperados (por exemplo, o intervalo de datas não é preservado). Se você tiver um único mês exibido com um intervalo de 04/01/2001 a 10/04/2001, rolar o calendário para trás alterará o intervalo selecionado da seguinte maneira: 03/01/2001 a 03/10/2001. Se você tiver vários meses exibidos, como março e abril com um intervalo selecionado de 04/01/2001 a 10/04/2001, rolar o calendário de volta para janeiro e fevereiro alterará o intervalo selecionado da seguinte maneira: 01/01/2001 a 01/10/2001.

Observação

Definir o SelectionRange MonthCalendar controle que tem estilos visuais habilitados resultará no intervalo de seleção que não está pintando corretamente no controle.

Aplica-se a

Confira também