WebPartZoneCollection.CopyTo(WebPartZoneBase[], Int32) Method
Definition
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.
Copies the collection to an array of WebPartZoneBase objects.
public:
void CopyTo(cli::array <System::Web::UI::WebControls::WebParts::WebPartZoneBase ^> ^ array, int index);
public void CopyTo (System.Web.UI.WebControls.WebParts.WebPartZoneBase[] array, int index);
member this.CopyTo : System.Web.UI.WebControls.WebParts.WebPartZoneBase[] * int -> unit
Public Sub CopyTo (array As WebPartZoneBase(), index As Integer)
Parameters
- array
- WebPartZoneBase[]
A WebPartZoneBase array to contain the copied collection.
- index
- Int32
The starting point in the array at which to place the collection contents.
Examples
The following code example demonstrates the use of the CopyTo method. The complete code for the example, including a user control, a page containing the zones, and a partial class file that contains the code, is found in the Example section of the WebPartZoneCollection class overview.
The following section of the code demonstrates usage of the CopyTo method. To execute the code, load the page in a browser, and click the Zone Names from Array button. The collection of zones is loaded into an array, and all zone IDs are copied into a label.
protected void Button3_Click(object sender, EventArgs e)
{
Label1.Text = String.Empty;
WebPartZoneBase[] zoneArray = new WebPartZoneBase[mgr.Zones.Count];
mgr.Zones.CopyTo(zoneArray, 0);
Label1.Text = zoneArray[2].ID;
Label1.Text += ", " + zoneArray[1].ID;
Label1.Text += ", " + zoneArray[0].ID;
}
Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
Label1.Text = String.Empty
Dim zoneArray(mgr.Zones.Count) As WebPartZoneBase
mgr.Zones.CopyTo(zoneArray, 0)
Label1.Text = zoneArray(2).ID
Label1.Text += ", " & zoneArray(1).ID
Label1.Text += ", " & zoneArray(0).ID
End Sub
Remarks
The CopyTo method is useful when you want to create a custom array that can contain the zones in the WebPartZoneCollection collection, a subset of those zones, or a superset of those zones.