| File: RootComponent.cs | Web Access |
| Project: src\src\BlazorWebView\src\Wpf\Microsoft.AspNetCore.Components.WebView.Wpf.csproj (Microsoft.AspNetCore.Components.WebView.Wpf) |
// Copyright (c) .NET Foundation. All rights reserved. // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. using System; using System.Collections.Generic; using System.Threading.Tasks; using Microsoft.AspNetCore.Components.WebView.WebView2; namespace Microsoft.AspNetCore.Components.WebView.Wpf { /// <summary> /// Describes a root component that can be added to a <see cref="BlazorWebView"/>. /// </summary> public class RootComponent { /// <summary> /// Gets or sets the CSS selector string that specifies where in the document the component should be placed. /// This must be unique among the root components within the <see cref="BlazorWebView"/>. /// </summary> public string Selector { get; set; } = default!; /// <summary> /// Gets or sets the type of the root component. This type must implement <see cref="IComponent"/>. /// </summary> public Type ComponentType { get; set; } = default!; /// <summary> /// Gets or sets an optional dictionary of parameters to pass to the root component. /// </summary> public IDictionary<string, object?>? Parameters { get; set; } internal Task AddToWebViewManagerAsync(WebViewManager webViewManager) { // As a characteristic of XAML,we can't rely on non-default constructors. So we have to // validate that the required properties were set. We could skip validating this and allow // the lower-level renderer code to throw, but that would be harder for developers to understand. if (string.IsNullOrWhiteSpace(Selector)) { throw new InvalidOperationException($"{nameof(RootComponent)} requires a value for its {nameof(Selector)} property, but no value was set."); } if (ComponentType is null) { throw new InvalidOperationException($"{nameof(RootComponent)} requires a value for its {nameof(ComponentType)} property, but no value was set."); } var parameterView = Parameters == null ? ParameterView.Empty : ParameterView.FromDictionary(Parameters); return webViewManager.AddRootComponentAsync(ComponentType, Selector, parameterView); } internal Task RemoveFromWebViewManagerAsync(WebView2WebViewManager webviewManager) { return webviewManager.RemoveRootComponentAsync(Selector); } } }