This property reflects the size of the current page. It also determines the size of new pages created by the AddPage method. Note that changing the MediaBox does not change the current Rect. So typically you'll want to write code like this:

[C#]

theDoc.MediaBox.String = "0 0 200 300";
theDoc.Rect.String = theDoc.MediaBox.String;

theDoc.MediaBox.String = "0 0 200 300"
theDoc.Rect.String = theDoc.MediaBox.String

Changing this property will change the size of pages created by subsequent calls to AddPage. However it will not change the size of the pages that have already been created. To change the size of the pages that have already been created you need to use the SetInfo method. For example:

[C#]

theDoc.SetInfo(theDoc.Page, "/MediaBox:Rect", "0 0 200 300");

theDoc.SetInfo(theDoc.Page, "/MediaBox:Rect", "0 0 200 300")

Similar methods can be used to control other page size measures such as the CropBox, BleedBox, TrimBox and ArtBox. For example:

[C#]

theDoc.SetInfo(theDoc.Page, "/CropBox:Rect", "20 20 180 280");

theDoc.SetInfo(theDoc.Page, "/CropBox:Rect", "20 20 180 280")

The default page size is often the one you'll want to use. However it may be that your PDFs are required to conform to a different page size. If this is the case you can simply specify the name of the size rather than the exact dimension. See the Rect.String property for details.

The following code creates a PDF document containing three different pages each with a different size.

[C#]

using (Doc doc = new Doc()) {
  doc.Page = doc.AddPage();
  doc.MediaBox.String = "A4";
  doc.Page = doc.AddPage();
  doc.MediaBox.String = "B5";
  doc.Page = doc.AddPage();
  doc.Save(Server.MapPath("docmediabox.pdf"));
}

Using doc As New Doc()
  doc.Page = doc.AddPage()
  doc.MediaBox.String = "A4"
  doc.Page = doc.AddPage()
  doc.MediaBox.String = "B5"
  doc.Page = doc.AddPage()
  doc.Save(Server.MapPath("docmediabox.pdf"))
End Using