PackageStore.GetPackage(Uri) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает из хранилища Package с указанным URI.
public:
static System::IO::Packaging::Package ^ GetPackage(Uri ^ uri);
public static System.IO.Packaging.Package GetPackage (Uri uri);
static member GetPackage : Uri -> System.IO.Packaging.Package
Public Shared Function GetPackage (uri As Uri) As Package
Параметры
- uri
- Uri
Универсальный код ресурса (URI) возвращаемого пакета.
Возвращаемое значение
Пакет с указанным packageUri
или null
, если в хранилище нет пакета с указанным packageUri
.
Исключения
packageUri
имеет значение null
.
packageUri
является недопустимым URI пакета.
Примеры
В следующем примере показано, как использовать метод GetPackage.
// --------------------------- OpenDocument ---------------------------
/// <summary>
/// Loads and displays a given XPS document file.</summary>
/// <param name="filename">
/// The path and file name of the XPS
/// document to load and display.</param>
/// <returns>
/// true if the document loads successfully; otherwise false.</returns>
public bool OpenDocument(string xpsFile)
{
// Check to see if the document is encrypted.
// If encrypted, use OpenEncryptedDocument().
if (EncryptedPackageEnvelope.IsEncryptedPackageEnvelope(xpsFile))
return OpenEncryptedDocument(xpsFile);
// Document is not encrypted, open normally.
ShowStatus("Opening '" + Filename(xpsFile) + "'");
_packageUri = new Uri(xpsFile, UriKind.Absolute);
try
{
_xpsDocument = new XpsDocument(xpsFile, FileAccess.Read);
}
catch (System.IO.FileFormatException ex)
{
MessageBox.Show(xpsFile + "\n\nThe file " +
"is not a valid XPS document.\n\n" +
"Exception: " + ex.Message + "\n\n" +
ex.GetType().ToString() + "\n\n" + ex.StackTrace,
"Invalid File Format",
MessageBoxButton.OK, MessageBoxImage.Error);
return false;
}
// Get the document's PackageStore into which
// new user annotations will be added and saved.
_xpsPackage = PackageStore.GetPackage(_packageUri);
if ((_xpsPackage == null) || (_xpsDocument == null))
{
MessageBox.Show("Unable to get Package from file.");
return false;
}
// Get the FixedDocumentSequence from the open document.
FixedDocumentSequence fds = _xpsDocument.GetFixedDocumentSequence();
if (fds == null)
{
MessageBox.Show(xpsFile + "\n\nThe document package within " +
"the specified file does not contain a " +
"FixedDocumentSequence.", "Package Error");
return false;
}
// Load the FixedDocumentSequence to the DocumentViewer control.
DocViewer.Document = fds;
// Enable document menu controls.
menuFileClose.IsEnabled = true;
menuFilePrint.IsEnabled = true;
menuViewIncreaseZoom.IsEnabled = true;
menuViewDecreaseZoom.IsEnabled = true;
// Give the DocumentViewer focus.
docViewer.Focus();
this.Title = "RightsManagedPackageViewer SDK Sample - " +
Filename(xpsFile);
return true;
}// end:OpenDocument()
' --------------------------- OpenDocument ---------------------------
''' <summary>
''' Loads and displays a given XPS document file.</summary>
''' <param name="filename">
''' The path and file name of the XPS
''' document to load and display.</param>
''' <returns>
''' true if the document loads successfully; otherwise false.</returns>
Public Function OpenDocument(ByVal xpsFile As String) As Boolean
' Check to see if the document is encrypted.
' If encrypted, use OpenEncryptedDocument().
If EncryptedPackageEnvelope.IsEncryptedPackageEnvelope(xpsFile) Then
Return OpenEncryptedDocument(xpsFile)
End If
' Document is not encrypted, open normally.
ShowStatus("Opening '" & Filename(xpsFile) & "'")
_packageUri = New Uri(xpsFile, UriKind.Absolute)
Try
_xpsDocument = New XpsDocument(xpsFile, FileAccess.Read)
Catch ex As System.IO.FileFormatException
MessageBox.Show(xpsFile & vbLf & vbLf & "The file " & "is not a valid XPS document." & vbLf & vbLf & "Exception: " & ex.Message & vbLf & vbLf & ex.GetType().ToString() & vbLf & vbLf & ex.StackTrace, "Invalid File Format", MessageBoxButton.OK, MessageBoxImage.Error)
Return False
End Try
' Get the document's PackageStore into which
' new user annotations will be added and saved.
_xpsPackage = PackageStore.GetPackage(_packageUri)
If (_xpsPackage Is Nothing) OrElse (_xpsDocument Is Nothing) Then
MessageBox.Show("Unable to get Package from file.")
Return False
End If
' Get the FixedDocumentSequence from the open document.
Dim fds As FixedDocumentSequence = _xpsDocument.GetFixedDocumentSequence()
If fds Is Nothing Then
MessageBox.Show(xpsFile & vbLf & vbLf & "The document package within " & "the specified file does not contain a " & "FixedDocumentSequence.", "Package Error")
Return False
End If
' Load the FixedDocumentSequence to the DocumentViewer control.
DocViewerProperty.Document = fds
' Enable document menu controls.
menuFileClose.IsEnabled = True
menuFilePrint.IsEnabled = True
menuViewIncreaseZoom.IsEnabled = True
menuViewDecreaseZoom.IsEnabled = True
' Give the DocumentViewer focus.
docViewer.Focus()
Me.Title = "RightsManagedPackageViewer SDK Sample - " & Filename(xpsFile)
Return True
End Function ' end:OpenDocument()
Комментарии
packageUri
сопоставляется с URI, указанными в вызове AddPackage метода.
Примечание по безопасности Для этого метода требуются все пользовательские EnvironmentPermissionPackage (не)ZipPackage типы.