PackageStore.RemovePackage(Uri) Method

Reference

Definition

Namespace:: System.IO.Packaging

Assembly:: PresentationCore.dll

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.

Removes the Package with a specified URI from the store.

public:
 static void RemovePackage(Uri ^ uri);

public static void RemovePackage (Uri uri);

static member RemovePackage : Uri -> unit

Public Shared Sub RemovePackage (uri As Uri)

Parameters

uri: Uri

The uniform resource identifier (URI) of the package to remove.

Exceptions

ArgumentNullException

packageUri is null.

ArgumentException

packageUri is an invalid package URI.

Examples

The following example shows how to use the RemovePackage method.

// --------------------------- CloseDocument --------------------------
/// <summary>
///   Closes the document currently displayed in
///   the DocumentViewer control.</summary>
public void CloseDocument()
{
    if (_xpsFile != null)
    {
        ShowStatus("Closing '" + Filename(_xpsFile) + "'");
        DocViewer.Document = null;
        _xpsFile = null;
    }

    // If the package is open, close it.
    if (_xpsPackage != null)
    {
        _xpsPackage.Close();
        _xpsPackage = null;
    }

    // The package is closed, remove it from the store.
    if (_packageUri != null)
    {
        PackageStore.RemovePackage(_packageUri);
        _packageUri = null;
    }

    // Disable document-related selections when there's no document.
    menuFileClose.IsEnabled = false;
    menuFilePrint.IsEnabled = false;
    menuViewIncreaseZoom.IsEnabled = false;
    menuViewDecreaseZoom.IsEnabled = false;
    this.Title = "RightsManagedPackageViewer SDK Sample";
    ShowPrompt(
        "Click 'File | Open...' to select a file to open and view.");
    rightsBlock.Text = "";
}// end:CloseDocument

' --------------------------- CloseDocument --------------------------
''' <summary>
'''   Closes the document currently displayed in
'''   the DocumentViewer control.</summary>
Public Sub CloseDocument()
    If _xpsFile IsNot Nothing Then
        ShowStatus("Closing '" & Filename(_xpsFile) & "'")
        DocViewerProperty.Document = Nothing
        _xpsFile = Nothing
    End If

    ' If the package is open, close it.
    If _xpsPackage IsNot Nothing Then
        _xpsPackage.Close()
        _xpsPackage = Nothing
    End If

    ' The package is closed, remove it from the store.
    If _packageUri IsNot Nothing Then
        PackageStore.RemovePackage(_packageUri)
        _packageUri = Nothing
    End If

    ' Disable document-related selections when there's no document.
    menuFileClose.IsEnabled = False
    menuFilePrint.IsEnabled = False
    menuViewIncreaseZoom.IsEnabled = False
    menuViewDecreaseZoom.IsEnabled = False
    Me.Title = "RightsManagedPackageViewer SDK Sample"
    ShowPrompt("Click 'File | Open...' to select a file to open and view.")
    rightsBlock.Text = ""

End Sub

Remarks

packageUri is matched to the URIs specified in the AddPackage method call.

Security Note This method demands EnvironmentPermission for all custom Package (non-ZipPackage) types.

Applies to