ControlCollection.AddListObject Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.Office.Tools.Excel
Bütünleştirilmiş Kodlar:
Microsoft.Office.Tools.Excel.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Aşırı Yüklemeler

AddListObject(ListObject)

Belirtilen yerel temelinde denetim koleksiyonuna bir Visual Studio ekler ListObject ListObject .
AddListObject(Range, String)

ListObjectBelirtilen aralıktaki çalışma sayfasına yeni bir denetim ekler.

AddListObject(ListObject)

Belirtilen yerel temelinde denetim koleksiyonuna bir Visual Studio ekler ListObject ListObject .

public Microsoft.Office.Tools.Excel.ListObject AddListObject (Microsoft.Office.Interop.Excel.ListObject listObject);

Parametreler

listObject
ListObject

Yerel ListObject .

Döndürülenler

ListObject

ListObjectDenetim koleksiyonuna eklenmiş olan Visual Studio.

Özel durumlar

ArgumentNullException

listObjectBağımsız değişken null , veya sıfır uzunluğuna sahip.

ControlNameAlreadyExistsException

ListObjectÖrneğe aynı ada sahip bir denetim zaten eklenmiş ControlCollection .

Açıklamalar

Bu yöntemi doğrudan kodunuzda çağırmamalıdır. Bunun yerine, Microsoft.Office.Tools.Excel.Extensions.ListObjectExtensions.GetVstoObject Visual Studio 'yu edinmek için genişletme yöntemini çağırın Microsoft.Office.Tools.Excel.ListObject .

Microsoft.Office.Tools.Excel.Extensions.ListObjectExtensions.GetVstoObjectGenişletme yöntemi, Microsoft.Office.Tools.Excel.ListObject yerel bir örneğine karşılık gelen bir Visual Studio oluşturmak için bu yöntemi kullanır Microsoft.Office.Interop.Excel.ListObject .

Microsoft.Office.Tools.Excel.Extensions.ListObjectExtensions.GetVstoObjectGenişletme yöntemi yalnızca bir kez genişletilmiş oluşturur Microsoft.Office.Tools.Excel.ListObject . Sonraki çağrılarında varolan Genişletilmiş nesnenin aynı örneğini döndürür. Buna karşılık, AddListObject her seferinde yeni bir genişletilmiş oluşturur Microsoft.Office.Tools.Excel.ListObject .

Şunlara uygulanır

AddListObject(Range, String)

ListObjectBelirtilen aralıktaki çalışma sayfasına yeni bir denetim ekler.

public Microsoft.Office.Tools.Excel.ListObject AddListObject (Microsoft.Office.Interop.Excel.Range range, string name);

Parametreler

range
Range

RangeDenetimin sınırlarını sağlayan bir.

name
String

Örnekteki denetimin dizinini eklemek için kullanılabilen denetimin adı ControlCollection .

Döndürülenler

ListObject

ListObjectÖrneğe eklenen denetim ControlCollection .

Özel durumlar

ArgumentNullException

Ad veya Aralık bağımsız değişkeni null ya da ad bağımsız değişkeninin sıfır uzunluğu vardır.

ControlNameAlreadyExistsException

Örnekte aynı ada sahip bir denetim zaten var ControlCollection .

InvalidRangeException

Belirtilen aralık geçersiz. Çok alanlı aralıklar kullanılamaz. Aralık, örnekle aynı çalışma sayfasında olmalıdır ControlCollection .

Örnekler

Aşağıdaki kod örneği, ListObject çalışma sayfasının üst kısmına bir denetim ekler ve içindeki satır sayısını gösteren bir ileti kutusu görüntüler ListObject .

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.");
}

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

Açıklamalar

AddListObjectYöntemi ListObject , öğesinin sonuna denetimler eklemenize olanak sağlar ControlCollection . ListObjectDaha önce programlı olarak eklenmiş bir denetimi kaldırmak için Remove yöntemini kullanın.

Şunlara uygulanır