ControlCollection.AddListObject Yöntem (Range, String)

Makale
02/17/2014

Yeni bir ekler ListObject denetimini çalışma sayfasına belirtilen aralıkta.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

'Bildirim
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject

ListObject AddListObject(
    Range range,
    string name
)

Parametreler

range
Tür: Microsoft.Office.Interop.Excel.Range
A Range , sınırları için denetim sağlar.

name
Tür: System.String
Denetimde dizini oluşturmak için kullanılan denetimin adını ControlCollection örneği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.ListObject
ListObject Eklenmiştir denetim ControlCollection örneği.

Özel Durumlar

Exception	Koşul
ArgumentNullException	Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), veya sıfır uzunluk değişkeni vardır.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim zaten kullanılıyor ControlCollection örneği.
InvalidRangeException	Belirtilen aralık geçersiz.Multi-Area aralıkları kullanılamaz.Aralığı aynı çalışma sayfasında olması gerekir ControlCollection örneği.

Notlar

AddListObject Yöntemi eklemenizi sağlar ListObject denetimleri sonuna kadar ControlCollection.Kaldırmak için bir ListObject önceden programlı olarak eklenen Denetim, kullanım Remove yöntem.

Örnekler

Aşağıdaki kod örneği ekler bir ListObject satırların sayısını gösteren bir ileti kutusu çalışma sayfası ve ardından görüntüler üstüne kontrol ListObject.

Private Sub ExcelAddListObject()
    Dim List1 As Microsoft.Office.Tools.Excel. _
        ListObject = Me.Controls.AddListObject( _
        Me.Range("A1", "C5"), "List1")

    MessageBox.Show("The list object has " _
        & List1.Range.Rows.Count.ToString() + " rows.")

End Sub

private void ExcelAddListObject()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "C5"], 
        "list1");
    MessageBox.Show("The list object has " + 
        list1.Range.Rows.Count.ToString() + " rows.");
}

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen Güvenilen Koddan Kitaplıkları Kullanma.