DesignSurface.CreateNestedContainer Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a container suitable for nesting controls or components.
| CreateNestedContainer(IComponent) |
Creates a container suitable for nesting controls or components. |
| CreateNestedContainer(IComponent, String) |
Creates a container suitable for nesting controls or components. |
- Source:
- DesignSurface.cs
- Source:
- DesignSurface.cs
- Source:
- DesignSurface.cs
Creates a container suitable for nesting controls or components.
public:
System::ComponentModel::INestedContainer ^ CreateNestedContainer(System::ComponentModel::IComponent ^ owningComponent);public System.ComponentModel.INestedContainer CreateNestedContainer(System.ComponentModel.IComponent owningComponent);member this.CreateNestedContainer : System.ComponentModel.IComponent -> System.ComponentModel.INestedContainerPublic Function CreateNestedContainer (owningComponent As IComponent) As INestedContainerParameters
- owningComponent
- IComponent
The component that manages the nested container.
Returns
The nested container.
Exceptions
owningComponent is null.
The IDesignerHost attached to the DesignSurface has been disposed.
Remarks
Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
- Source:
- DesignSurface.cs
- Source:
- DesignSurface.cs
- Source:
- DesignSurface.cs
Creates a container suitable for nesting controls or components.
public:
System::ComponentModel::INestedContainer ^ CreateNestedContainer(System::ComponentModel::IComponent ^ owningComponent, System::String ^ containerName);public System.ComponentModel.INestedContainer CreateNestedContainer(System.ComponentModel.IComponent owningComponent, string containerName);public System.ComponentModel.INestedContainer CreateNestedContainer(System.ComponentModel.IComponent owningComponent, string? containerName);member this.CreateNestedContainer : System.ComponentModel.IComponent * string -> System.ComponentModel.INestedContainerPublic Function CreateNestedContainer (owningComponent As IComponent, containerName As String) As INestedContainerParameters
- owningComponent
- IComponent
The component that manages the nested container.
- containerName
- String
An additional name for the nested container.
Returns
The nested container.
Exceptions
owningComponent is null.
The IDesignerHost attached to the DesignSurface has been disposed.
Remarks
Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization.
You can provide an additional name for the CreateNestedContainer method by passing a value into containerName.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: