Class IContainerExtensions

Contains extension methods for IContainer.

Inheritance
System.Object
IContainerExtensions
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: EPiServer.Shell.ViewComposition
Assembly: EPiServer.Shell.dll
Version: 8.11.0
Syntax
public static class IContainerExtensions

Methods

AddComponentsRecursive(IContainer, String, IEnumerable<IPluggableComponentDefinition>, IPrincipal)

Tries to add the components to one of the containers in the given root container.

Declaration
public static void AddComponentsRecursive(this IContainer container, string viewName, IEnumerable<IPluggableComponentDefinition> pluggableComponents, IPrincipal principal)
Parameters
Type Name Description
IContainer container

The container.

System.String viewName

The name of the view.

System.Collections.Generic.IEnumerable<IPluggableComponentDefinition> pluggableComponents

The components.

System.Security.Principal.IPrincipal principal

The principal.

FindComponentById(IContainer, Guid)

Finds the component that matches the given id or null if no matching component exists.

Declaration
public static IComponent FindComponentById(this IContainer container, Guid id)
Parameters
Type Name Description
IContainer container

The container to search in.

System.Guid id

The id to match.

Returns
Type Description
IComponent

The component that matches the given id or null if no matching container exists.

FindComponentById(IContainer, Guid, ref IContainer)

Finds the component that matches the given id or null if no matching component exists.

Declaration
public static IComponent FindComponentById(this IContainer container, Guid id, ref IContainer personalizationContainer)
Parameters
Type Name Description
IContainer container

The container to search in.

System.Guid id

The id to match.

IContainer personalizationContainer

The personalization container.

Returns
Type Description
IComponent

The component that matches the given id or null if no matching container exists.

FindContainerByPlugInArea(IContainer, String)

Gets the first container in the container hierarchy that matches plug in path.

Declaration
public static IContainer FindContainerByPlugInArea(this IContainer container, string plugInArea)
Parameters
Type Name Description
IContainer container

The container.

System.String plugInArea

The plug in area.

Returns
Type Description
IContainer

The first container in the container hierarchy that matches plug in path.

GetComponentList(IContainer)

Gets a list with all widget types currently in the containers component structure.

Declaration
public static IEnumerable<string> GetComponentList(this IContainer container)
Parameters
Type Name Description
IContainer container

The container.

Returns
Type Description
System.Collections.Generic.IEnumerable<System.String>

A list with all widget types currently in the containers component structure.

RemoveComponentsRecursive(IContainer, IEnumerable<IComponentMatcher>, Boolean)

Tries to remove any components in any of the containers in the given root container structure that matches the components plug-in path and type.

Declaration
public static void RemoveComponentsRecursive(this IContainer container, IEnumerable<IComponentMatcher> componentMatchers, bool notifyComponentOnRemoval)
Parameters
Type Name Description
IContainer container

The container.

System.Collections.Generic.IEnumerable<IComponentMatcher> componentMatchers

The component matchers.

System.Boolean notifyComponentOnRemoval

if set to true any component that implement IComponentNotify are notified when removed.

ReplaceContainersRecursive(IContainer, IEnumerable<IContainer>, IComponentManager)

Replaces all containers in the container tree with any container in the replacementContainer list that matches the plug-in path.

Declaration
public static void ReplaceContainersRecursive(this IContainer container, IEnumerable<IContainer> replacementContainers, IComponentManager componentManager)
Parameters
Type Name Description
IContainer container

The container to alter.

System.Collections.Generic.IEnumerable<IContainer> replacementContainers

The replacement containers.

IComponentManager componentManager

The component manager suppling components from component definitions.

Remarks

This method will never replace the root container, only children in the container tree.