WebMatrix Site Workspace Help

This page is a quick visual guide to the Site Workspace in the WebMatrix user interface.

WebMatrix Site Workspace Help

The Site workspace helps you monitor web requests and configure website settings. To access this workspace, select Site in the workspace selector of WebMatrix.

Site Settings Ribbon

Site Requests Ribbon

Site Setting Tasks

Site Request Tasks

Related Topics

siteworkspace-1

Site Settings Ribbon

siteworkspace-2

UI

Description

My Sites

Lists existing sites that you can open.

Publish

Lets you configure settings for publishing the site.

Run

Runs the site or the currently selected file in the browser.

Start

Starts IIS Express.

Stop

Stops IIS Express.

Restart

Stops IIS Express and releases resources, and then restarts IIS Express.

Requests

Displays the local requests of your site.

Site Requests Ribbon

siteworkspace-3

UI

Description

Clear All

Clears the list of requests.

Only Errors

Displays only requests that resulted in errors.

Ignore Images

Removes requests from the listing that only get images.

Capture Requests

Turns request monitoring on or off.

Site Setting Tasks

Task

Action

View site settings

Click Settings in the navigation pane.

Set the URL and port number (binding) for testing your site

Enter a URL and optionally a port number. This setting is preconfigured by WebMatrix and you typically do not have to change it. If you change the URL to something other than "localhost", you must ensure that the domain is registered in the hosts file or DNS server.

Note: Incorrectly changing this setting can prevent your site from working correctly.

You might change the port number if the default port conflicts with another process or if you need to test a process that requires a fixed port number.

These settings are applied globally to WebMatrix. They are not included when you publish the site.

Enable encrypted connections using SSL for testing locally

Select Enable SSL. This lets you test SSL (https:// protocol) while working in WebMatrix by using a self-signed certificate with IIS Express. SSL provides confidentiality (encryption) for sensitive information sent between the browser and your website.

This setting is applied globally and is not included when you publish the site. For more information see, Securing Web Communications: Certificates, SSL, and https://.

Set the .NET Framework version for your site

Select a version from the list. You typically run your site using the latest .NET Framework version. However, if you need to make your site backward compatible, you can choose an earlier version. The available versions are:

  • .NET 4 (Integrated). Use with IIS 7.0 to provide improved performance for .NET Framework 4 applications.

  • .NET 4 (Classic). Use for backward compatibility with IIS 6.0 and earlier versions when you run a web application that uses the .NET Framework 4. This option usually requires few or no modifications to existing applications.

  • .NET 2 (Integrated). Use with IIS 7.0 to provide improved performance for .NET Framework 2.0 applications.

  • .NET 2 (Classic). Use for backward compatibility with IIS 6.0 and earlier versions when you run a web application that uses the .NET Framework 2.0.

If you choose to run a PHP application, set the .NET Framework version to none.

This setting is applied globally. When you publish the site, WebMatrix includes this setting if your hosting provider allows it. You can apply this setting to your remote site by running a compatibility check. To do this, click Publish, and then click Check Compatibility in the ribbon.

Enable PHP support

Under PHP Settings, select the Enable PHP check box. You must select an available PHP version. If it is not already installed, WebMatrix guides you through the installation steps.

This setting is applied globally and is not included when you publish the site.

Manage default pages

The pages listed in the content pane are those that IIS or IIS Express will try to run when the request URL does not point to a specific page.

You can reorder and delete default pages by using the arrows and delete button. To add a default page, click Add.

This setting is stored in the web.config file and is included when you publish the site.

Site Request Tasks

Task

Action

View requests

Click Requests in the View group in the ribbon. In the content pane, select an individual request to see details. The status of requests is indicated by the following values:

  • 2xx = Success.

  • 3xx = Informational (for example, the request has been redirected to a different page).

  • 4xx = Error on the client (for example, a request to non-existent page or a request for a protected resource).

  • 5xx = Error on the server.

For more information, see Analyze Requests to your Website.

Search for a specific request

At the top of the content pane, enter the text to find. You can search for any characters that appear in the report, such as "304.0".

View errors

Click Only Errors in the ribbon. Select an individual error in the content pane for details and to see recommendations about how to resolve the error.

Clear existing requests

Click Clear All in the ribbon.

Stop capturing requests (or restart)

Click Capture Requests in the ribbon.

Related Topics

Your First Website Using WebMatrix

Using WebMatrix to Make your Website SEO Friendly

Analyze Requests to your Website

Introduction to Debugging

Download and Install a PHP Application

Customizing Site-Wide Behavior

You can discuss this article using the adjacent Facebook talkback.

For technical questions please visit our discussion forums, where we have a vibrant community of developers like you, as well as Microsoft engineers who are ready to answer your questions!