Metoda ControlCollection.AddListObject — (Range, String)
Dodaje nowy ListObject formantu do arkusza, w zakresie określonym.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)
Składnia
'Deklaracja
Function AddListObject ( _
range As Range, _
name As String _
) As ListObject
ListObject AddListObject(
Range range,
string name
)
Parametry
- range
Typ: Microsoft.Office.Interop.Excel.Range
A Range do celów kontroli i zapewniających granice.
- name
Typ: System.String
Nazwa formantu, który może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.
Wartość zwracana
Typ: Microsoft.Office.Tools.Excel.ListObject
ListObject Kontroli, który został dodany do ControlCollection wystąpienie.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | Argument Nazwa lub zakres jest nullodwołanie o wartości null (Nothing w języku Visual Basic), albo argumentu Nazwa ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już w ControlCollection wystąpienie. |
| InvalidRangeException | Określony zakres jest nieprawidłowy.Nie można użyć Multi-Area zakresów.Zakres powinien być na tym samym arkuszu co ControlCollection wystąpienie. |
Uwagi
AddListObject Metoda umożliwia dodanie ListObject formanty na koniec ControlCollection.Aby usunąć ListObject kontroli, jakie zostały uprzednio dodane programowo, użyj Remove metody.
Przykłady
Poniższy kod dodaje ListObject kontroli na początek arkusza, a następnie wyświetla okno komunikatu pokazujący liczbę wierszy w 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.");
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.