CatalogPartCollection.Contains(CatalogPart) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, показывающее, существует ли конкретный элемент управления в коллекции.
public:
bool Contains(System::Web::UI::WebControls::WebParts::CatalogPart ^ catalogPart);public bool Contains (System.Web.UI.WebControls.WebParts.CatalogPart catalogPart);member this.Contains : System.Web.UI.WebControls.WebParts.CatalogPart -> boolPublic Function Contains (catalogPart As CatalogPart) As BooleanПараметры
- catalogPart
- CatalogPart
Объект CatalogPart, наличие которого проверяется в коллекции.
Возвращаемое значение
Логическое значение, указывающее на наличие или отсутствие конкретного элемента управления в коллекции.
Примеры
В следующем примере кода показано, как определить, является ли определенный CatalogPart элемент управления членом CatalogPartCollection объекта. Полный код, необходимый для запуска примера, см. в разделе "Пример" раздела CatalogPartCollection обзора класса.
Код в методе Button1_Click создает новый CatalogPartCollection объект с именем myParts. Метод использует Contains метод, чтобы определить, существует ли PageCatalogPart1 элемент управления, и, если да, извлекает элемент управления и изменяет значение свойства.
protected void Button1_Click(object sender, EventArgs e)
{
ArrayList list = new ArrayList(2);
list.Add(PageCatalogPart1);
list.Add(DeclarativeCatalogPart1);
// Pass an ICollection object to the constructor.
CatalogPartCollection myParts = new CatalogPartCollection(list);
foreach (CatalogPart catalog in myParts)
{
catalog.Description = "My " + catalog.DisplayTitle;
}
// Use the IndexOf property to locate a CatalogPart control.
int PageCatalogPartIndex = myParts.IndexOf(PageCatalogPart1);
myParts[PageCatalogPartIndex].ChromeType = PartChromeType.TitleOnly;
// Use the Contains method to see if a CatalogPart control exists.
if (myParts.Contains(PageCatalogPart1))
{
WebPart closedWebPart = null;
WebPartDescriptionCollection descriptions = PageCatalogPart1.GetAvailableWebPartDescriptions();
if (descriptions.Count > 0)
{
closedWebPart = PageCatalogPart1.GetWebPart(descriptions[0]);
closedWebPart.AllowClose = false;
}
}
// Use indexers to display the details of the CatalogPart controls.
Label1.Text = String.Empty;
Label1.Text =
"<h3>PageCatalogPart Details</h3>" +
"ID: " + myParts[0].ID + "<br />" +
"Count: " + myParts[0].GetAvailableWebPartDescriptions().Count;
Label1.Text +=
"<h3>DeclarativeCatalogPart Details</h3>" +
"ID: " + myParts["DeclarativeCatalogPart1"].ID + "<br />" +
"Count: " + myParts["DeclarativeCatalogPart1"].GetAvailableWebPartDescriptions().Count;
}
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim list As New ArrayList(2)
list.Add(PageCatalogPart1)
list.Add(DeclarativeCatalogPart1)
' Pass an ICollection object to the constructor.
Dim myParts As New CatalogPartCollection(list)
Dim catalog As CatalogPart
For Each catalog In myParts
catalog.Description = "My " + catalog.DisplayTitle
Next catalog
' Use the IndexOf property to locate a CatalogPart control.
Dim PageCatalogPartIndex As Integer = _
myParts.IndexOf(PageCatalogPart1)
myParts(PageCatalogPartIndex).ChromeType = PartChromeType.TitleOnly
' Use the Contains method to see if a CatalogPart control exists.
If myParts.Contains(PageCatalogPart1) Then
Dim closedWebPart As WebPart = Nothing
Dim descriptions As WebPartDescriptionCollection = _
PageCatalogPart1.GetAvailableWebPartDescriptions()
If descriptions.Count > 0 Then
closedWebPart = PageCatalogPart1.GetWebPart(descriptions(0))
closedWebPart.AllowClose = False
End If
End If
' Use indexers to display the details of the CatalogPart controls.
Label1.Text = String.Empty
Label1.Text = _
"<h3>PageCatalogPart Details</h3>" & _
"ID: " & myParts(0).ID + "<br />" & _
"Count: " & myParts(0).GetAvailableWebPartDescriptions().Count
Label1.Text += _
"<h3>DeclarativeCatalogPart Details</h3>" & _
"ID: " & myParts("DeclarativeCatalogPart1").ID & "<br />" & _
"Count: " & myParts("DeclarativeCatalogPart1") _
.GetAvailableWebPartDescriptions().Count
End Sub
При загрузке страницы в браузере можно переключить страницу в режим каталога, выбрав " Каталог " в раскрывающемся списке " Режим отображения ". Добавьте пользовательский WebPart элемент управления на страницу, установив флажок рядом с ним и нажав кнопку "Добавить". Нажмите кнопку "Закрыть ", чтобы вернуть страницу для просмотра в режиме обзора. Если вы только что добавили элемент управления, щелкните меню команд (стрелка вниз, которая отображается в строке заголовка), а затем нажмите кнопку "Закрыть", элемент управления удаляется со страницы и добавляется в PageCatalogPart элемент управления. Верните страницу в режим каталога и щелкните ссылку "Каталог страниц" , чтобы просмотреть содержимое PageCatalogPart элемента управления. Обратите внимание, что элемент управления, который вы закрыли, был добавлен в него. Нажатие кнопки "Свойства display CatalogPart" обращается к объекту CatalogPartCollection и отображает определенные свойства автономных CatalogPart элементов управления. Установите флажок рядом с серверным элементом управления, содержащимся в PageCatalogPart элементе управления, нажмите кнопку "Добавить ", чтобы добавить его обратно на страницу, а затем нажмите кнопку "Закрыть ", чтобы вернуть страницу в режим обзора. Снова щелкните меню команд в элементе управления и обратите внимание, что теперь команда закрытия исчезла. Он был удален кодом в Button1_Click методе, когда он использовал Contains метод для проверки PageCatalogPart1, а затем присвоил его AllowClose свойству falseзначение .
Комментарии
Этот Contains метод позволяет определить, является ли конкретный CatalogPart объект частью CatalogPartCollection объекта.