CheckedListBox.DisplayMember Właściwość

Definicja

Pobiera lub ustawia ciąg określający Właściwość obiektów zawartych w polu listy, których zawartość ma zostać wyświetlona.Gets or sets a string that specifies a property of the objects contained in the list box whose contents you want to display.

public:
 property System::String ^ DisplayMember { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string DisplayMember { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DisplayMember : string with get, set
Public Property DisplayMember As String

Wartość właściwości

String

Ciąg określający nazwę właściwości obiektów zawartych w polu listy.A string that specifies the name of a property of the objects contained in the list box. Wartością domyślną jest ciąg pusty ("").The default is an empty string ("").

Atrybuty

Przykłady

Poniższy przykład kodu demonstruje inicjalizację CheckedListBox kontrolki przez ustawienie CheckOnClick właściwości, SelectionMode , i ThreeDCheckBoxes .The following code example demonstrates initializing a CheckedListBox control by setting the CheckOnClick, SelectionMode, and ThreeDCheckBoxes properties. Przykład wypełnia CheckedListBox formant with i ustawia DisplayMember Właściwość na na Control.Name właściwości kontrolki.The example populates the CheckedListBox with controls and sets the DisplayMember to the Control.Name property of the control.

Aby uruchomić przykład, wklej następujący kod w postaci zawierającej CheckedListBox nazwę CheckedListBox1 i Wywołaj InitializeCheckListBox metodę z konstruktora formularza lub metody ładowania.To run the example, paste the following code in a form containing a CheckedListBox named CheckedListBox1 and call the InitializeCheckListBox method from the form's constructor or Load method.

   // This method initializes CheckedListBox1 with a list of all 
   // the controls on the form. It sets the selection mode
   // to single selection and allows selection with a single click.
   // It adds itself to the list before adding itself to the form.
internal:
   System::Windows::Forms::CheckedListBox^ CheckedListBox1;

private:
   void InitializeCheckedListBox()
   {
      this->CheckedListBox1 = gcnew CheckedListBox;
      this->CheckedListBox1->Location = System::Drawing::Point( 40, 90 );
      this->CheckedListBox1->CheckOnClick = true;
      this->CheckedListBox1->Name = "CheckedListBox1";
      this->CheckedListBox1->Size = System::Drawing::Size( 120, 94 );
      this->CheckedListBox1->TabIndex = 1;
      this->CheckedListBox1->SelectionMode = SelectionMode::One;
      this->CheckedListBox1->ThreeDCheckBoxes = true;
      System::Collections::IEnumerator^ myEnum = this->Controls->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Control^ aControl = safe_cast<Control^>(myEnum->Current);
         this->CheckedListBox1->Items->Add( aControl, false );
      }

      this->CheckedListBox1->DisplayMember = "Name";
      this->CheckedListBox1->Items->Add( CheckedListBox1 );
      this->Controls->Add( this->CheckedListBox1 );
   }
// This method initializes CheckedListBox1 with a list of all 
// the controls on the form. It sets the selection mode
// to single selection and allows selection with a single click.
// It adds itself to the list before adding itself to the form.

internal System.Windows.Forms.CheckedListBox CheckedListBox1;

private void InitializeCheckedListBox()
{
    this.CheckedListBox1 = new CheckedListBox();
    this.CheckedListBox1.Location = new System.Drawing.Point(40, 90);
    this.CheckedListBox1.CheckOnClick = true;
    this.CheckedListBox1.Name = "CheckedListBox1";
    this.CheckedListBox1.Size = new System.Drawing.Size(120, 94);
    this.CheckedListBox1.TabIndex = 1;
    this.CheckedListBox1.SelectionMode = SelectionMode.One;
    this.CheckedListBox1.ThreeDCheckBoxes = true;

    foreach ( Control aControl in this.Controls )
    {
        this.CheckedListBox1.Items.Add(aControl, false);
    }

    this.CheckedListBox1.DisplayMember = "Name";
    this.CheckedListBox1.Items.Add(CheckedListBox1);
    this.Controls.Add(this.CheckedListBox1);
}
' This method initializes CheckedListBox1 with a list of all the controls
' on the form. It sets the selection mode to single selection and
' allows selection with a single click. It adds itself to the list before 
' adding itself to the form.
Friend WithEvents CheckedListBox1 As System.Windows.Forms.CheckedListBox

Private Sub InitializeCheckedListBox()
    Me.CheckedListBox1 = New CheckedListBox
    Me.CheckedListBox1.Location = New System.Drawing.Point(40, 90)
    Me.CheckedListBox1.CheckOnClick = True
    Me.CheckedListBox1.Name = "CheckedListBox1"
    Me.CheckedListBox1.Size = New System.Drawing.Size(120, 94)
    Me.CheckedListBox1.TabIndex = 1
    Me.CheckedListBox1.SelectionMode = SelectionMode.One
    Me.CheckedListBox1.ThreeDCheckBoxes = True

    Dim aControl As Control
    For Each aControl In Me.Controls
        Me.CheckedListBox1.Items.Add(aControl, False)
    Next

    Me.CheckedListBox1.DisplayMember = "Name"
    Me.CheckedListBox1.Items.Add(CheckedListBox1)
    Me.Controls.Add(Me.CheckedListBox1)
End Sub

Uwagi

Domyślnie CheckedListBox wyświetla domyślny ciąg dla elementów, które zawiera.By default the CheckedListBox displays the default string for the items it contains. CheckedListBoxMożna jednak wyświetlić różne typy obiektów i zmienić wyświetlany ciąg przez określenie DisplayMember właściwości.However, the CheckedListBox can display diverse types of objects and you may want to change the displayed string by specifying the DisplayMember property. Jeśli określona właściwość nie istnieje lub wartość DisplayMember właściwości jest ciągiem pustym (""), ToString zamiast tego są wyświetlane wyniki metody obiektu.If the specified property does not exist, or the value of the DisplayMember property is an empty string (""), the results of the object's ToString method are displayed instead.

Jeśli DisplayMember nie można ustawić nowej wartości, Poprzednia wartość jest utrzymywana.If the new value of the DisplayMember cannot be set, the previous value is maintained.

Dotyczy