-
+
+
+
+
+
Zoom
+
+
+
+
+
Go To Page
+
Print
+
Download
-
Go To Page
-
Download
-
Print
+ @ref="@Viewer">
+
+
@code {
- SfPdfViewer2 Viewer;
- SfTextBox TextBox1;
- SfTextBox TextBox2;
+ private SfPdfViewer2? Viewer;
+ private SfTextBox? TextBox1;
+ private SfTextBox? TextBox2;
public string DocumentPath { get; set; } = "wwwroot/pdf-succinctly.pdf";
- // Access the loaded PDF Viewer instance - Zoom functionality
- public async void OnZoomClick(MouseEventArgs args)
+ private DocumentInfo Info = new();
+
+ // Read document information on load
+ private void OnDocumentLoaded(LoadEventArgs args)
{
- int zoomValue = int.Parse(TextBox1.Value.ToString());
- await Viewer.ZoomAsync(zoomValue);
+ Info = new DocumentInfo
+ {
+ Name = args.DocumentName,
+ PageCount = args.PageCount,
+ };
}
- // Navigate to a specific page
- public async void OnPageClick(MouseEventArgs args)
+
+ // Handle document load failures
+ private void OnDocumentLoadFailed(FailureEventArgs args)
+ {
+ Console.Error.WriteLine($"Failed to load document: {args.ErrorMessage}");
+ }
+
+ // Zoom functionality (valid range: 50-400)
+ private async Task OnZoomClick(MouseEventArgs args)
+ {
+ try
+ {
+ await Viewer.ZoomAsync(zoomValue);
+ }
+ catch (Exception ex)
+ {
+ Console.Error.WriteLine($"Zoom failed: {ex.Message}");
+ }
+ }
+
+ // Navigate to a specific 1-based page
+ private async Task OnPageClick(MouseEventArgs args)
{
- int pageIndex = int.Parse(TextBox2.Value.ToString());
- await Viewer.GoToPageAsync(pageIndex);
+ try
+ {
+ await Viewer.GoToPageAsync(pageIndex);
+ }
+ catch (Exception ex)
+ {
+ Console.Error.WriteLine($"Navigation failed: {ex.Message}");
+ }
}
-
+
// Print the PDF document
- public async void OnClick(MouseEventArgs args)
+ private async Task OnPrintClick(MouseEventArgs args)
{
- await Viewer.PrintAsync();
+ if (Viewer is null) return;
+ await Viewer.PrintAsync();
}
-
+
// Download the PDF document
- public async void OnClickDownload(MouseEventArgs args)
+ private async Task OnClickDownload(MouseEventArgs args)
{
- await Viewer.DownloadAsync();
+ if (Viewer is null) return;
+ await Viewer.DownloadAsync();
}
}
```
-## See also
-- [Blazor PDF Viewer –API Reference](https://help.syncfusion.com/cr/blazor/syncfusion.blazor.sfpdfviewer.sfpdfviewer2.html)
-- [Blazor FAQ](https://help.syncfusion.com/document-processing/pdf/pdf-viewer/blazor/faq) (e.g., Magnification, Navigation, Print) — ensure the features you need are available
\ No newline at end of file
+## See Also
+
+- [Blazor PDF Viewer – API Reference](https://help.syncfusion.com/cr/blazor/syncfusion.blazor.sfpdfviewer.sfpdfviewer2.html)
+- [Magnification (Zoom) in Blazor PDF Viewer](../magnification)
+- [Navigation in Blazor PDF Viewer](../interactive-pdf-navigation-overview)
+- [Print PDF in Blazor PDF Viewer](../print/overview)
+- [Download PDF in Blazor PDF Viewer](../saving-pdf-file#download)
+- [Blazor PDF Viewer FAQ](../faq)
\ No newline at end of file
diff --git a/Document-Processing/PDF/PDF-Viewer/blazor/document-security/password-protected.md b/Document-Processing/PDF/PDF-Viewer/blazor/document-security/password-protected.md
index a677ad178f..d6b5014fcb 100644
--- a/Document-Processing/PDF/PDF-Viewer/blazor/document-security/password-protected.md
+++ b/Document-Processing/PDF/PDF-Viewer/blazor/document-security/password-protected.md
@@ -9,11 +9,7 @@ documentation: ug
# Password-protected documents
-Some PDFs require a password to open. When such a document is loaded in the viewer, the following behavior applies:
-
-- A password prompt appears if the document requires an password.
-
-The viewer displays a password prompt UI when a protected document is opened.
+Some PDFs require a password to open. When a protected document is loaded, the viewer displays a password prompt automatically.
**Desktop password prompt:**
@@ -23,45 +19,82 @@ The viewer displays a password prompt UI when a protected document is opened.
-- If the correct password is provided, the document loads and becomes viewable per the document’s permissions.
+The viewer handles the prompt as follows:
+
+- If the correct password is provided, the document loads and becomes viewable according to the document's permissions.
- If the password is incorrect, the viewer shows an error and continues to prompt until a valid password is entered or the operation is canceled.
**Invalid password error in desktop:**
-**Invalid password error in Mobile:**
+**Invalid password error in mobile:**
- If the operation is canceled, the document is not loaded.
+## Detect load errors
+
+Handle incorrect-password events through the [`DocumentLoadFailed`](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SfPdfViewer.PdfViewerEvents.html#Syncfusion_Blazor_SfPdfViewer_PdfViewerEvents_DocumentLoadFailed) event to surface custom error messages.
+
+## Supported permissions
+
+When the document loads successfully, the viewer respects the permissions embedded in the PDF. Common restrictions include:
+
+- Printing allowed or disallowed
+- Content copying
+- Page editing
+- Commenting and annotations
+
+The viewer cannot bypass or elevate document permissions. For the full list of owner-controlled permissions, see [Permission-protected documents](./permission).
+
## Load the password-protected document programmatically
-Use the [LoadAsync method](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SfPdfViewer.PdfViewerBase.html) to load a PDF from a file path, URL, or base64 data at runtime. Pass the password as the second parameter.
+Use the [`LoadAsync`](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SfPdfViewer.PdfViewerBase.html#Syncfusion_Blazor_SfPdfViewer_PdfViewerBase_LoadAsync_System_Byte___System_String_) method to load a PDF from a file path, URL, or base64 data at runtime. The two supported overloads are:
+
+- `LoadAsync(byte[] bytes, string password = null)` — pass the PDF as a byte array
+- `LoadAsync(string document, string password = null)` — pass a URL or server-relative path
-```cshtml
+The password parameter is consumed for the current load operation only and is not cached across re-renders. If the document is reloaded, supply the password again.
+```csharp
+@page "/password-protected"
@using Syncfusion.Blazor.SfPdfViewer
@using Syncfusion.Blazor.Buttons
-
Load Document
+
Load Document
-@code{
- SfPdfViewer2 Viewer;
+@code {
+ private SfPdfViewer2? Viewer;
- public async void clicked()
+ private async Task Clicked()
{
+ if (Viewer is null)
+ {
+ return;
+ }
+
await Viewer.LoadAsync("wwwroot/pdf-succinctly-password-protected.pdf", "password");
}
}
-
```
+N> The sample uses a `wwwroot/` path, which is appropriate for Blazor WebAssembly. For Blazor Server, load the file from a server-accessible location (for example, pass a byte array returned from an API) and use the `byte[]` overload.
+
+**Outcomes**
+
+| Password state | Result |
+|---|---|
+| Correct | The PDF loads immediately |
+| Incorrect | The viewer displays the incorrect password popup |
+| Null or empty | The password popup is shown automatically |
+
[View sample in GitHub](https://github.com/SyncfusionExamples/blazor-pdf-viewer-examples/tree/master/Load%20and%20Save/Load%20the%20Security%20Document).
## See Also
-* [Permission-protected documents](./permission)
\ No newline at end of file
+* [Permission-protected documents](./permission)
+* [Load a Password-Protected PDF in Blazor](../document-handling/load-password-pdf)
diff --git a/Document-Processing/PDF/PDF-Viewer/blazor/document-security/permission.md b/Document-Processing/PDF/PDF-Viewer/blazor/document-security/permission.md
index 19bb1dcd35..cb457b69e5 100644
--- a/Document-Processing/PDF/PDF-Viewer/blazor/document-security/permission.md
+++ b/Document-Processing/PDF/PDF-Viewer/blazor/document-security/permission.md
@@ -9,45 +9,57 @@ documentation: ug
# Permission-restricted documents (Owner password and permissions)
-PDFs can be secured with an owner password and a set of permissions that restrict operations even after opening the file. Examples include:
+PDFs can be secured with an owner password and a set of permissions that restrict operations after the file is opened. Common restrictions include:
-- Printing: allowed or disallowed
-- Content copying
-- Page editing
+- Printing (allowed or disallowed)
+- Copying content
+- Editing pages
- Commenting and annotations
-The viewer respects these permission flags and disables restricted actions in its UI. It cannot bypass or elevate document permissions. For example, when printing is disallowed, the print action is not available; when copying is restricted, text selection may be limited or copy commands disabled.
+The viewer respects these permission flags and disables restricted actions in its UI. It cannot bypass or elevate document permissions. For example, when printing is disallowed, the print action is disabled; when copying is restricted, text selection is limited or copy commands are disabled.
**UI when a permission-restricted document is loaded:**
-
+
## Load the permission-protected document programmatically
-Use the [LoadAsync method](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SfPdfViewer.PdfViewerBase.html) to load a PDF from a file path, URL, or base64 data at runtime. Provide the password parameter only if the PDF also has an open/user password.
+Use the [`LoadAsync`](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SfPdfViewer.PdfViewerBase.html#Syncfusion_Blazor_SfPdfViewer_PdfViewerBase_LoadAsync_System_Byte___System_String_) method to load a PDF from a file path, URL, or base64 data at runtime. The supported overloads are:
-```cshtml
+- `LoadAsync(byte[] bytes, string password = null)` — load the PDF as a byte array
+- `LoadAsync(string document, string password = null)` — load a URL or server-relative path
+- `LoadAsync(Stream stream, string password = null)` — load a PDF Document from the stream.
+```csharp
+@page "/permission-protected"
@using Syncfusion.Blazor.SfPdfViewer
@using Syncfusion.Blazor.Buttons
-
Load Document
-
-
+
+ Load Document
+
+
+
-@code{
- SfPdfViewer2 Viewer;
+@code {
+ private SfPdfViewer2? Viewer;
- public async void clicked()
+ private async Task Clicked()
{
- await Viewer.LoadAsync("wwwroot/permission-protected.pdf", "password");
+ if (Viewer is null)
+ {
+ return;
+ }
+
+ await Viewer.LoadAsync("wwwroot/permission-protected.pdf");
}
}
-
```
-[View sample in GitHub](https://github.com/SyncfusionExamples/blazor-pdf-viewer-examples/tree/master/Load%20and%20Save/Load%20the%20Security%20Document).
+N> [View sample in GitHub](https://github.com/SyncfusionExamples/blazor-pdf-viewer-examples/tree/master/Load%20and%20Save/Load%20the%20Security%20Document).
## See Also
-* [Password-protected documents](./password-protected)
\ No newline at end of file
+* [Password-protected documents](./password-protected)
+* [Getting started with SfPdfViewer2](../getting-started/web-app)
+* [SfPdfViewer2 API reference](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.SfPdfViewer.PdfViewerBase.html)
\ No newline at end of file
diff --git a/Document-Processing/PDF/PDF-Viewer/blazor/images/open-pdf.png b/Document-Processing/PDF/PDF-Viewer/blazor/images/open-pdf.png
new file mode 100644
index 0000000000..f82d0440f3
Binary files /dev/null and b/Document-Processing/PDF/PDF-Viewer/blazor/images/open-pdf.png differ
diff --git a/Document-Processing/PDF/PDF-Viewer/blazor/images/password-popup.png b/Document-Processing/PDF/PDF-Viewer/blazor/images/password-popup.png
new file mode 100644
index 0000000000..2a3a3263c9
Binary files /dev/null and b/Document-Processing/PDF/PDF-Viewer/blazor/images/password-popup.png differ