Metoda IConfigureToolboxItem.ConfigureToolboxItem —

Artykuł
10/27/2012

Wywołana przez usługę przybornika, aby skonfigurować ToolboxItem obiektów.

Przestrzeń nazw: Microsoft.VisualStudio.Shell
Zestaw: Microsoft.VisualStudio.Shell.11.0 (w Microsoft.VisualStudio.Shell.11.0.dll)

Składnia

'Deklaracja
Sub ConfigureToolboxItem ( _
    item As ToolboxItem _
)

void ConfigureToolboxItem(
    ToolboxItem item
)

Parametry

item
Typ: System.Drawing.Design.ToolboxItem
[w] ToolboxItem Obiektu, którego konfiguracja ma zostać zmodyfikowana.

Uwagi

Usługa przybornik wywołuje metodę tym podczas ToolboxItem obiektów, najpierw są dodawane do Przybornik, lub gdy Przybornik jest resetowany.Metoda ta zmienia dane w swoim słowniku właściwości z określonego ToolboxItem i.Zmiany te są szeregowane i przechowywane jako Visual Studio IDE, ustawienia użytkownika.

Przykłady

W przykładzie poniżej klasy ToolboxItemConfig implementuje IConfigureToolboxItem interfejsu dla wszystkich bibliotek w Vsip obszaru nazw.Ustawia tę implementację ToolboxItemFilterAttribute dla elementu przybornika ToolboxControl1 tak, że jest ona dostępna w Przybornik tylko podczas edytowania UserControli dla elementu przybornika ToolboxControl2 , dzięki czemu nie jest dostępna w Przybornik podczas edycji UserControl.

namespace Vsip.ItemConfiguration {
    [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]
    [Guid("11BA3E17-12F1-4e48-9E34-AC68335CD9EE")]
    public sealed class ToolboxConfig : IConfigureToolboxItem {
        ...
        public void ConfigureToolboxItem(ToolboxItem item) {
            if (item == null)
                return;
            ToolboxItemFilterAttribute newFilter = null;
            if (item.TypeName == typeof(ToolboxControl1).ToString()) {
                newFilter = new ToolboxItemFilterAttribute("System.Windows.Forms.UserControl",
                                                   ToolboxItemFilterType.Require);
            } 
            else if (item.TypeName == typeof(ToolboxControl2).ToString()) {
                newFilter = new ToolboxItemFilterAttribute("System.Windows.Forms.UserControl",
                                                      ToolboxItemFilterType.Prevent);
            }
            if (newFilter != null) {
                ArrayList array = new ArrayList();
                array.Add(newFilter);
                item.Filter = (ToolboxItemFilterAttribute[])
                        array.ToArray(typeof(ToolboxItemFilterAttribute));
            }
        }
    }
}

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 Przy użyciu bibliotek z częściowo zaufanego kodu..