ControlExtensions.AddDataGridView Yöntem (ControlCollection, Range, String)

Makale
02/17/2014

Yeni bir ekler DataGridView belirtilen aralık çalışma sayfası denetimi.

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

Sözdizimi

'Bildirim
<ExtensionAttribute> _
Public Shared Function AddDataGridView ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As DataGridView

public static DataGridView AddDataGridView(
    this ControlCollection controls,
    Range range,
    string name
)

Parametreler

controls
Tür: Microsoft.Office.Tools.Excel.ControlCollection
Denetim eklemek için koleksiyon.Bu parametre kendinizin saðlamasý değil.Tarafından döndürülen koleksiyonu bu yöntem aradığınızda Worksheet.Controls (uygulama düzeyinde projedeki) özelliği veya WorksheetBase.Controls özelliği (bir belge düzeyinde projesinde), bu parametre otomatik olarak sağlanır.

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

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

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.Controls.DataGridView
DataGridView Eklenmiştir Denetim ControlCollection örneği.

Kullanım Notu

Visual Basic ve C# programlarında, bu yöntemi ControlCollection türündeki herhangi bir nesne üzerinde örnek yöntemi olarak çağırabilirsiniz. Bu yöntemi çağırmak için örnek yöntemi sözdizimini kullandığınızda, ilk parametreyi yok sayın. Daha fazla bilgi için bkz. Uzantı Yöntemleri (Visual Basic) veya Genişletme Yöntemleri (C# Programlama Kılavuzu).

Özel Durumlar

Exception	Koşul
ArgumentNullException	Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), ya da name bağımsız değişkeni sıfır uzunlukta.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim içinde ControlCollection örneği.
InvalidRangeException	Belirtilen aralık geçerli değil.Multi-Area aralıkları kullanılamaz.Aralığı aynı çalışma sayfasında olması gereken ControlCollection örneği.

Notlar

AddDataGridView Yöntemi eklemenize olanak sağlayan DataGridView sonuna kadar nesne ControlCollection.Kaldırmak için bir DataGridView , daha önce eklenmiştir programlı olarak, kullanmak Remove yöntemi.

Aralığı yeniden boyutlandırıldığında denetimi otomatik olarak yeniden boyutlandırır.

Örnekler

Aşağıdaki kod örneği ekler bir DataGridView hücreleri denetime A1 ile D9ve sonra denetlemek için iki sütun ekler.Çalıştır buradan bu örneği kullanmak için Sheet1 bir belge düzeyinde proje sınıfında.

    Private Sub ExcelRangeAddDataGridView()

        Dim DataGridView1 As Microsoft.Office.Tools.Excel. _
            Controls.DataGridView = Me.Controls. _
            AddDataGridView(Me.Range("A1", "D9"), _
            "DataGridView1")
        DataGridView1.Columns.Add("firsName", "First Name")
        DataGridView1.Columns.Add("lastName", "Last Name")

    End Sub

private void ExcelRangeAddDataGridView()
{

    Microsoft.Office.Tools.Excel.Controls.DataGridView
        dataGridView1 = this.Controls.AddDataGridView(
        this.Range["A1", "D9"], "dataGridView1");
    dataGridView1.Columns.Add("firsName", "First Name");
    dataGridView1.Columns.Add("lastName", "Last Name");
}

.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.

Ayrıca bkz.

Başvuru

ControlExtensions Sınıf

AddDataGridView Fazla Yük

Microsoft.Office.Tools.Excel Ad Alanı

Aracılığıyla paylaş