mam własną aplikację webową w c# (asp.net). Potrzebuję wykorzystać silnik umbraco do…
- User
mam własną aplikację webową w c# (asp.net). Potrzebuję wykorzystać silnik umbraco do renderowania contentu przygotowanego przez CMSa Umbraco (zapisanego w jego własnym formacie, etc.). Chcę otrzymać wynikowy HTML, który mogę przekazać jako response w mojej aplikacji webowej. Chcę przygotować model danych przekazać go do silnika umbraco. Chcę mieć kontrolę nad tym jaka sekcja ze strony przygotowanej w umbraco ma być renderowana za pomocą enginu. Nie używam asp.net mvc
Assistant
Rozumiem Twój problem i jest to ciekawe wyzwanie, ponieważ chcesz wykorzystać wewnętrzny silnik renderujący Umbraco w sposób, w jaki nie jest on standardowo przeznaczony do działania – czyli poza pełnym kontekstem aplikacji Umbraco. Standardowo Umbraco renderuje całe strony w ramach własnego pipeline'u ASP.NET.
Chcąc uzyskać tylko HTML z konkretnego contentu lub sekcji, musisz "zbootować" Umbraco w swojej aplikacji i skorzystać z jego wewnętrznych serwisów. Jest to możliwe, ale wymaga pewnego ustawienia kontekstu.
Poniżej przedstawiam podejście dla Umbraco 8 (ponieważ ASP.NET Web Forms często idzie w parze z tą wersją lub starszymi). Nowsze wersje Umbraco (9+) bazują na .NET Core, co zmienia nieco mechanizm ładowania, ale ogólna koncepcja (pobranie IPublishedContent i użycie renderera) pozostaje podobna.
Kluczowe Elementy do Wykorzystania
UmbracoContext: Umbraco silnie bazuje na swoim kontekście. Będziesz musiał go stworzyć i utrzymać.IPublishedContent: To jest model danych, który Umbraco przekazuje do szablonów. Będziesz musiał go pobrać dla węzła, który chcesz renderować.IRazorRenderer: To jest serwis Umbraco odpowiedzialny za renderowanie widoków Razor.- Szablony (Templates): Będziesz potrzebował dostępu do plików szablonów Umbraco (
.cshtml).
Krok po Kroku:
1. Wymagane Pakiety NuGet
Upewnij się, że w Twojej aplikacji Web Forms masz zainstalowane odpowiednie pakiety Umbraco. Minimalnie potrzebujesz:
UmbracoCms.Web(to zazwyczaj wystarczy, aby pobrać wszystkie niezbędne zależności)UmbracoCms.Core
Ważne: Spowoduje to dodanie wielu zależności Umbraco do Twojej aplikacji. Upewnij się, że nie ma konfliktów wersji.
2. Konfiguracja i Bootstrapping Umbraco w Global.asax
Umbraco musi zostać "zbootowane", aby jego serwisy były dostępne. Najlepszym miejscem na to jest
Application_Startw Twoim plikuGlobal.asax.cs.// Global.asax.cs using System; using System.Web; using System.Web.Routing; using Umbraco.Core.Composing; // For Umbraco 8 using Umbraco.Core; // For Umbraco 8 using Umbraco.Web; // For Umbraco 8 using Umbraco.Web.PublishedCache; using Umbraco.Core.Cache; using Umbraco.Core.IO; using Umbraco.Core.Logging; using Umbraco.Core.Services; using Umbraco.Core.Configuration.UmbracoSettings; using Umbraco.Core.Configuration; using Umbraco.Core.Scoping; using Umbraco.Core.Models.PublishedContent; using System.IO; using Umbraco.Core.Mapping; public class Global : HttpApplication { private Umbraco.Core.Runtime.CoreRuntime _umbracoCoreRuntime; protected void Application_Start(object sender, EventArgs e) { // 1. Inicjalizacja Umbraco Runtime // To jest kluczowy krok, który uruchamia wewnętrzne serwisy Umbraco. // Konieczne jest wskazanie katalogu root Umbraco, gdzie znajdują się pliki views, config itd. // Jeśli Twoja aplikacja Web Forms jest w tym samym katalogu co Umbraco (lub masz dostęp do jego plików), // możesz użyć Server.MapPath("~") lub wskazać ścieżkę do instalacji Umbraco. // Przyjmujemy, że pliki Umbraco (np. config/umbracoSettings.config, views/) są dostępne w tym samym projekcie // lub w innym miejscu, które jest skonfigurowane w web.config dla Umbraco. // Upewnij się, że masz sekcje w web.config dla Umbraco, np. umbracoConfiguration, umbracoContent etc. // Minimalnie może być potrzebna sekcja <umbracoConfiguration>. try { // Przykład dla Umbraco 8: // Musimy zaimplementować IWebRuntime and IUmbracoBoot // Najprościej jest pozwolić Umbraco zarządzać swoim życiem // ale musimy upewnić się, że ścieżki są poprawne. // Ten fragment jest bardzo wrażliwy na konfigurację i wersję Umbraco. // Będziesz potrzebować umbraco.config, Umbraco.Core.dll, Umbraco.Web.dll, // i wszystkich innych plików Umbraco, które są wymagane do jego działania, // w folderze bin Twojej aplikacji. // W przypadku Umbraco 8, to nie jest tak proste jak bezpośrednie wywołanie. // Umbraco 8 używa Composerów i Components. // Zwykle Umbraco 8 inicjuje się poprzez klasę WebRuntime, która implementuje IUmbracoBoot. // Jeśli po prostu dodasz pakiety NuGet Umbraco do swojej aplikacji, // Umbraco powinno spróbować się zainicjować automatycznie. // Jeśli chcesz ręcznie inicjalizować Umbraco 8, musisz zbudować odpowiednie obiekty: var globalSettings = new GlobalSettings(); var logger = new DebugDiagnosticsLogger(new LoggerSettings()); // Debug logger, replace with real one var configFactory = new UmbracoConfigurationFactory(logger, globalSettings); // This is the tricky part. For Umbraco 8, you'd usually have a full Umbraco app. // To run parts of it, you might need to mock some of its dependencies or let it load // via its normal startup process (which means your app *is* Umbraco). // However, a common trick for "hybrid" Umbraco 8 setups // is to let Umbraco boot normally, but then access its services. // Ensure your web.config is set up correctly for Umbraco (database connection, folders, etc.). // If Umbraco.Cms.Web (or UmbracoCms.Web) package is installed, // Umbraco should *attempt* to start itself. // We just need to make sure its dependencies are met (config, database). // For Umbraco 8, you would typically use the Umbraco.Web.Runtime.WebRuntime class // which extends Umbraco.Core.Runtime.CoreRuntime. // It has methods like "Boot". // Simplified approach for illustration (might need adjustment based on your setup): // Accessing Current.Factory directly might work AFTER Umbraco has booted itself. // Umbraco.Web.Composing.Current.Factory will be null before boot. // This line implies Umbraco is configured to run itself. // If you don't have a full Umbraco instance and just the DLLs, // this will fail. You might need to manually set up a container. // For a minimal setup, consider using Umbraco 7 or mocking more aggressively. // A more robust Umbraco 8 setup for *external* usage: // You'd need to manually create an Umbraco Context and configure dependencies. // This is complex and involves mocking `HttpContext`, `IUmbracoContextFactory` etc. // The simplest path: Install UmbracoCms.Web and configure it *as if* it was a full Umbraco site. // Even if you only use parts of it. This means: // 1. Umbraco database connection in web.config. // 2. Umbraco specific web.config sections (umbracoConfiguration, etc.). // 3. Proper folder structure (App_Plugins, bin, Umbraco, Umbraco_Client, Views). // 4. Ensure `UmbracoApplication` is used in Global.asax or `Umbraco.Web.umbracoModule` in web.config. // If your Global.asax inherits from Umbraco.Web.UmbracoApplication, // then Umbraco will boot itself. If not, you need to call boot manually. // Example if you *don't* inherit UmbracoApplication: // Create a concrete instance of WebRuntime and boot it. // var runtime = new Umbraco.Web.Runtime.WebRuntime( // new Umbraco.Core.Configuration.GlobalSettings(), // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // new Umbraco.Web.PublishedCache.PublishedCacheService( // new PublishedCacheServiceOptions(), // new Umbraco.Core.Cache.AppCaches( // new Umbraco.Core.Cache.DeepCloneAppCache(new Umbraco.Core.Cache.NoAppCache()), // new Umbraco.Core.Cache.NoAppCache(), // new Umbraco.Core.Cache.NoAppCache()), // logger, // new NoSqlBulkInserter()), // new Umbraco.Core.IO.DefaultFileSystems(logger, new IOHelper(new GlobalSettings(), new System.Configuration.Configuration()), new GlobalSettings()), // new Umbraco.Core.Logging.LogFormatter(new DebugDiagnosticsLogger(new LoggerSettings())), // new Umbraco.Core.Mapping.MapDefinitionCollectionBuilder( // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // logger), // new Umbraco.Core.Persistence.UmbracoDatabaseFactory( // new Umbraco.Core.Configuration.UmbracoSettings.UmbracoSettingsSection()), // new Umbraco.Core.PropertyEditors.PropertyValueEditorsCollectionBuilder( // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // logger, // new PropertyEditorCollectionBuilder( // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // logger)), // new Umbraco.Core.Services.UmbracoServices( // new Umbraco.Core.Persistence.SqlSyntax.SqlSyntaxProviderResolver( // new Umbraco.Core.Configuration.UmbracoSettings.UmbracoSettingsSection()), // new Umbraco.Core.Persistence.UmbracoDatabaseFactory( // new Umbraco.Core.Configuration.UmbracoSettings.UmbracoSettingsSection()), // new Umbraco.Core.Scoping.ScopeProvider( // new Umbraco.Core.Persistence.UmbracoDatabaseFactory( // new Umbraco.Core.Configuration.UmbracoSettings.UmbracoSettingsSection())), // new Umbraco.Core.Cache.AppCaches( // new Umbraco.Core.Cache.DeepCloneAppCache(new Umbraco.Core.Cache.NoAppCache()), // new Umbraco.Core.Cache.NoAppCache(), // new Umbraco.Core.Cache.NoAppCache()), // logger, // new Umbraco.Core.Configuration.UmbracoSettings.UmbracoSettingsSection(), // new Umbraco.Core.Web.IO.MediaFileManager( // new DefaultFileSystems(logger, new IOHelper(new GlobalSettings(), new System.Configuration.Configuration()), new GlobalSettings()), // new MediaFileSystem( // new DefaultFileSystems(logger, new IOHelper(new GlobalSettings(), new System.Configuration.Configuration()), new GlobalSettings()))), // new Umbraco.Core.IO.DefaultFileSystems(logger, new IOHelper(new GlobalSettings(), new System.Configuration.Configuration()), new GlobalSettings())), // new Umbraco.Core.Web.IO.MediaFileManager( // new DefaultFileSystems(logger, new IOHelper(new GlobalSettings(), new System.Configuration.Configuration()), new GlobalSettings()), // new MediaFileSystem( // new DefaultFileSystems(logger, new IOHelper(new GlobalSettings(), new System.Configuration.Configuration()), new GlobalSettings()))), // new Umbraco.Core.Persistence.UmbracoDatabaseFactory( // new Umbraco.Core.Configuration.UmbracoSettings.UmbracoSettingsSection()), // new Umbraco.Core.Web.PublishedCache.PublishedCacheService( // new PublishedCacheServiceOptions(), // new Umbraco.Core.Cache.AppCaches( // new Umbraco.Core.Cache.DeepCloneAppCache(new Umbraco.Core.Cache.NoAppCache()), // new Umbraco.Core.Cache.NoAppCache(), // new Umbraco.Core.Cache.NoAppCache()), // logger, // new NoSqlBulkInserter()), // new Umbraco.Core.Web.PublishedCache.PublishedUrlProvider( // new Umbraco.Core.Web.PublishedCache.UrlProviderOptions(), // new Umbraco.Core.PropertyEditors.PropertyValueConvertersCollectionBuilder( // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // logger)), // new Umbraco.Core.Web.PublishedCache.UrlSegmentProviderCollectionBuilder( // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // logger), // new Umbraco.Core.PropertyEditors.PropertyValueConvertersCollectionBuilder( // new Umbraco.Core.Composing.TypeLoaderFactory( // new Umbraco.Core.Composing.DefaultTypeFinder(logger, new CacheHelper(new NoAppCache(), new NoAppCache(), new PropertyCache()), new DirectoryInfo(Server.MapPath("~/bin")), new DirectoryInfo(Server.MapPath("~/App_Data/TEMP"))), // logger, // new NoAppCache()), // logger)); // runtime.Boot(); // The easiest way for Umbraco 8: // Ensure Global.asax inherits from Umbraco.Web.UmbracoApplication (and set up web.config). // Or use a custom class that calls: // (new Umbraco.Web.WebRuntime()).Boot(); // This is what UmbracoApplication effectively does. // If Umbraco.Web.UmbracoApplication is used, it handles the boot sequence. // If not, you need to initialize Umbraco's core services. This is complex. // Assuming your project structure and web.config are set up for Umbraco to boot itself. // If not, you're looking at a much more complex manual dependency injection setup. System.Web.Routing.RouteTable.Routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); System.Web.Routing.RouteTable.Routes.MapPageRoute("Default", "{*path}", "~/Default.aspx"); } catch (Exception ex) { // Log the error during Umbraco boot System.Diagnostics.Trace.WriteLine($"Umbraco boot error: {ex.Message}"); // Handle the error appropriately, perhaps show a friendly error page. } } protected void Application_End(object sender, EventArgs e) { // For Umbraco 8, you might call: // _umbracoCoreRuntime?.Terminate(); } }Komentarz do Bootstrappingu dla Umbraco 8: Najprostszym sposobem na uruchomienie Umbraco 8 w Twojej aplikacji jest skonfigurowanie jej tak, jakby była pełną instalacją Umbraco (plik
web.configz połączeniem do bazy danych, sekcjamiumbracoConfiguration,umbracoContentitp., oraz pliki w odpowiednich folderach:Views,Umbraco,umbraco.config). Wtedy, jeśli TwójGlobal.asax.csdziedziczy poUmbraco.Web.UmbracoApplication, Umbraco samo się zbootuje. W przeciwnym razie, ręczne bootowanie Umbraco 8 jest skomplikowane ze względu na jego architekturę opartą na Composers i Components.3. Klasa Pomocnicza do Renderowania Umbraco Contentu
Stwórz klasę statyczną lub singleton, która będzie używać serwisów Umbraco do renderowania.
// App_Code/UmbracoRendererService.cs using System; using System.IO; using System.Web; using System.Web.Mvc; // Umbraco RazorRenderer uses MVC concepts using System.Web.Routing; using Umbraco.Core; using Umbraco.Core.Composing; using Umbraco.Core.Models.PublishedContent; using Umbraco.Core.Services; using Umbraco.Web; using Umbraco.Web.Composing; using Umbraco.Web.PublishedCache; using Umbraco.Web.Rendering; public static class UmbracoRendererService { /// <summary> /// Renderuje content z Umbraco node na podstawie ID i opcjonalnie aliasu szablonu. /// Jeśli chcesz renderować konkretną "sekcję", najlepiej, aby była to oddzielna partial view /// lub konkretna właściwość contentu. /// </summary> /// <param name="nodeId">ID węzła Umbraco.</param> /// <param name="templateAlias">Alias szablonu (np. "TextPage"). Jeśli null, użyty zostanie domyślny szablon węzła.</param> /// <param name="partialViewAlias">Alias partial view do renderowania konkretnej sekcji (np. "_MainContentSection").</param> /// <returns>Renderowany HTML lub null w przypadku błędu.</returns> public static string RenderUmbracoContent(int nodeId, string templateAlias = null, string partialViewAlias = null) { if (Current.UmbracoContext == null) { // Kontekst Umbraco nie jest aktywny. Spróbuj go zainicjalizować. // UWAGA: To jest uproszczenie. W prawdziwej aplikacji to powinno być zarządzane przez Global.asax // lub dedykowany mechanizm DI / IUmbracoBoot. // Dla Umbraco 8: var umbracoContextFactory = Current.Factory.GetInstance<IUmbracoContextFactory>(); if (umbracoContextFactory == null) { // Umbraco nie jest poprawnie zbootowane. System.Diagnostics.Trace.WriteLine("Umbraco Context Factory not found. Umbraco might not be booted correctly."); return null; } // Tworzenie dummy kontekstu HTTP, jeśli go nie ma if (HttpContext.Current == null) { // Tworzenie fałszywego kontekstu HTTP jest skomplikowane i może prowadzić do problemów. // Umbraco silnie polega na HttpContext.Current. // Jeśli uruchamiasz to w tle bez aktywnego żądania HTTP, to jest duży problem. // Zakładamy, że uruchamiasz to w ramach żądania Web Forms, gdzie HttpContext.Current jest dostępne. System.Diagnostics.Trace.WriteLine("HttpContext.Current is null. Cannot create Umbraco context."); return null; } try { // Użycie using zapewnia poprawne zwolnienie zasobów UmbracoContextReference using (var umbracoContextReference = umbracoContextFactory.EnsureUmbracoContext(HttpContext.Current)) { // Upewnij się, że UmbracoContext.Current jest ustawiony // (EnsureUmbracoContext powinien to zrobić w ramach swojego działania) return RenderInternal(nodeId, templateAlias, partialViewAlias, umbracoContextReference.UmbracoContext); } } catch (Exception ex) { System.Diagnostics.Trace.WriteLine($"Error ensuring Umbraco context: {ex.Message}"); return null; } } else { // Kontekst Umbraco jest już aktywny return RenderInternal(nodeId, templateAlias, partialViewAlias, Current.UmbracoContext); } } private static string RenderInternal(int nodeId, string templateAlias, string partialViewAlias, UmbracoContext umbracoContext) { IPublishedContent node = umbracoContext.Content.GetById(nodeId); if (node == null) { System.Diagnostics.Trace.WriteLine($"Umbraco node with ID {nodeId} not found."); return null; } try { var razorRenderer = Current.Factory.GetInstance<IRazorRenderer>(); if (razorRenderer == null) { System.Diagnostics.Trace.WriteLine("IRazorRenderer service not found. Umbraco might not be fully configured."); return null; } string result = null; if (!string.IsNullOrEmpty(partialViewAlias)) { // Renderowanie Partial View // Umbraco expects a ControllerContext for rendering partials. // This is where it gets tricky without MVC. // You might need to create a dummy ControllerContext. // A more direct way to render a partial view in Web Forms: // Create a dummy HttpContext var dummyHttpContext = new HttpContextWrapper(HttpContext.Current ?? new HttpContext(new HttpRequest("", "http://localhost/", ""), new HttpResponse(new StringWriter()))); var routeData = new RouteData(); routeData.Values.Add("controller", "Dummy"); // Dummy controller name var requestContext = new RequestContext(dummyHttpContext, routeData); // Create a dummy Controller (doesn't need to exist, just for context) var controller = new System.Web.Mvc.Controller(); var controllerContext = new ControllerContext(requestContext, controller); // Create a dummy ViewContext var viewContext = new ViewContext(controllerContext, new WebFormView(controllerContext, "dummy path"), // Dummy view new ViewDataDictionary(node), // Pass the IPublishedContent as Model new TempDataDictionary(), TextWriter.Null); // Get the partial view engine var partialViewEngine = Current.Factory.GetInstance<IPublishedContentQuery>().GetTemplateService().TemplateEngines.FindPartialView(viewContext, partialViewAlias, false); if (partialViewEngine.View != null) { // If you want to render a specific property that holds HTML (e.g., from a Rich Text Editor) // You don't need a partial view for this, just get the property value: // var htmlProperty = node.Value<IHtmlEncodedString>("yourRichTextPropertyAlias"); // return htmlProperty?.ToHtmlString(); // This is complex. The IRazorRenderer is for full templates. // For partials, you'd typically use a different mechanism or simply fetch the property value. // If your "section" is a specific property, just return node.Value<string>("yourPropertyAlias"); // If your "section" is truly a partial Razor file, the below is closer, // but directly using IRazorRenderer for partials is not its primary role. // It's for full templates (Umbraco views). // The most reliable way to render a partial from Umbraco within this context // would be to use HtmlHelper extensions (which require an MVC ViewContext), // or to create a simple Umbraco surface controller that returns a partial view. // Simpler for a "section": if your section is simply a content property, retrieve it directly. // E.g., if you have a property alias "mainContentHtml" // return node.Value<string>("mainContentHtml"); // If you truly have a Razor partial view, you might need to create a dummy MVC controller // and use its RenderPartial method, or simulate a full MVC context. // This is moving further away from "no MVC". } else { System.Diagnostics.Trace.WriteLine($"Partial view '{partialViewAlias}' not found."); return null; } } else { // Renderowanie pełnego szablonu Umbraco string finalTemplateAlias = templateAlias ?? node.ContentType.Alias; // Fallback to content type alias if no specific template is given // Umbraco 8 template resolver: var template = Umbraco.Web.PublishedCache.PublishedSnapshotService.Instance.PublishedSnapshot.Templates.Get(finalTemplateAlias); if (template == null) { System.Diagnostics.Trace.WriteLine($"Template with alias '{finalTemplateAlias}' not found for node ID {nodeId}."); return null; } // Renderowanie za pomocą IRazorRenderer // UWAGA: RenderAsync wymaga IUmbracoContext, który musi być aktywny var context = new PublishedContentRequest(node, umbracoContext.Content, umbracoContext.Content.GetTemplateService(), Umbraco.Web.Composing.Current.Factory.GetInstance<IUmbracoContextFactory>().EnsureUmbracoContext(HttpContext.Current).UmbracoContext); // Set the template for the request. context.SetTemplate(template); // This is the key call: result = razorRenderer.RenderAsync(context).Result; // .Result to synchronously wait for async operation } return result; } catch (Exception ex) { System.Diagnostics.Trace.WriteLine($"Error rendering Umbraco content for node ID {nodeId}: {ex.Message}"); return null; } } }4. Użycie w Stronie Web Forms (
.aspx.cs)Teraz możesz wywołać tę metodę w code-behind swojej strony Web Forms:
// YourWebPage.aspx.cs using System; using System.Web.UI; public partial class YourWebPage : Page { protected void Page_Load(object sender, EventArgs e) { if (!IsPostBack) { int umbracoNodeId = 1060; // Przykładowe ID węzła z Umbraco // Przykład 1: Renderuj całą stronę z domyślnym szablonem string fullPageHtml = UmbracoRendererService.RenderUmbracoContent(umbracoNodeId); if (!string.IsNullOrEmpty(fullPageHtml)) { MyLiteralControl.Text = fullPageHtml; } else { MyLiteralControl.Text = "Błąd renderowania Umbraco contentu lub content nie znaleziony."; } // Przykład 2: Renderuj content używając konkretnego szablonu // string specificTemplateHtml = UmbracoRendererService.RenderUmbracoContent(umbracoNodeId, "MyCustomTemplateAlias"); // MyLiteralControl.Text = specificTemplateHtml; // Przykład 3: Renderuj konkretną sekcję (poprzez partial view) // To jest najbardziej problematyczne, bo Umbraco RazorRenderer nie jest do tego przeznaczone. // Najlepszym rozwiązaniem jest, jeśli "sekcja" to po prostu właściwość contentu (np. pole RTE): // IPublishedContent node = Current.UmbracoContext.Content.GetById(umbracoNodeId); // string richTextContent = node?.Value<string>("mainContent"); // Assuming 'mainContent' is an RTE property // MyLiteralControl.Text = richTextContent; // Jeśli "sekcja" to faktycznie partial view w Umbraco: // Musiałbyś stworzyć swój własny silnik do renderowania partiali z Umbraco // albo faktycznie przekazać IPublishedContent do kontrolki użytkownika Web Forms // i tam użyć bardziej tradycyjnych metod ASP.NET do wyświetlania, // ale to już odchodzi od "silnika Umbraco". // Sugeruję, aby "sekcja" była po prostu właściwością węzła Umbraco, // którą pobierzesz i wyświetlisz, np. node.Value<IHtmlEncodedString>("richTextSection").ToHtmlString(); // Jeśli chcesz renderować partial view, musiałbyś dostosować metodę RenderUmbracoContent // do wykorzystania IViewEngine lub IRazorViewEngine MVC, co wymaga bardziej zaawansowanych // sztuczek z kontekstem MVC w aplikacji Web Forms. // To jest poza zakresem IRazorRenderer. } } }Komentarz do renderowania "sekcji":
-
Właściwości contentu: Jeśli Twoja "sekcja" to po prostu wartość konkretnej właściwości węzła (np. pole typu Rich Text Editor), możesz ją pobrać bezpośrednio:
IPublishedContent node = umbracoContext.Content.GetById(nodeId); if (node != null) { string sectionHtml = node.Value<string>("yourSectionPropertyAlias"); // lub node.Value<IHtmlEncodedString>("yourSectionPropertyAlias").ToHtmlString() // ... użyj sectionHtml }To jest najprostsze i najbardziej "czyste" rozwiązanie dla "sekcji".
-
Partial Views: Renderowanie tylko partial view z Umbraco za pomocą
IRazorRendererjest bardzo trudne, ponieważIRazorRendererjest przeznaczony do renderowania pełnych szablonów Umbraco. Partial views w Umbraco są zazwyczaj renderowane przezHtml.Partial()lubHtml.RenderPartial()w kontekście kontrolera MVC. Aby to zrobić w Web Forms, musiałbyś stworzyć sztucznyControllerContextiViewContext, co jest skomplikowane i łamie założenie "nie używam ASP.NET MVC".Rekomendacja dla sekcji: Jeśli "sekcja" to złożony fragment HTML, który chcesz definiować w Umbraco, najlepszym rozwiązaniem jest:
- Stworzenie dedykowanego szablonu Umbraco (np.
SectionTemplate.cshtml), który zawiera tylko ten jeden fragment, nie zawiera layoutu ani innych nagłówków/stopki. - Następnie wywołanie
UmbracoRendererService.RenderUmbracoContent(nodeId, "SectionTemplate")dla tego węzła. W ten sposób Umbraco renderuje cały plik szablonu, ale ten plik zawiera tylko interesującą Cię "sekcję". - Alternatywnie, użyj Umbraco jako headless CMS (Umbraco API), pobierz dane w formacie JSON i wyrenderuj je po swojej stronie za pomocą własnych technologii (np. JavaScript na stronie Web Forms). To jest jednak inne podejście niż wykorzystanie silnika renderującego Umbraco.
- Stworzenie dedykowanego szablonu Umbraco (np.
Ważne Uwagi i Potencjalne Problemy:
- Konfiguracja Umbraco: Twoja aplikacja Web Forms musi mieć dostęp do konfiguracji Umbraco (
web.config) i do jego plików (szablony, plikiumbraco.configwApp_Data, folderUmbracoetc.). Umbraco musi być w stanie znaleźć swoją bazę danych i pliki. - Kontekst HTTP: Umbraco silnie polega na
HttpContext.Current. Jeśli próbujesz renderować content w wątku w tle (bez aktywnego żądania HTTP), będziesz musiał stworzyć i zarządzać sztucznymHttpContext, co jest bardzo skomplikowane. To rozwiązanie zakłada, że wywołujesz je w ramach normalnego żądania Web Forms. - Wersje Umbraco: Powyższy kod jest dostosowany do Umbraco 8. Jeśli używasz Umbraco 9+ (które jest na .NET Core), proces bootowania i dostępu do serwisów będzie znacząco inny (używa
IServiceProviderzMicrosoft.Extensions.DependencyInjection). - Zależności: Dodanie pakietów Umbraco do istniejącej aplikacji może wprowadzić konflikty zależności z innymi bibliotekami, których używasz. Uważnie monitoruj logi i komunikaty o błędach.
- Wydajność: Bootowanie Umbraco i utrzymywanie jego kontekstu może być kosztowne. Upewnij się, że robisz to raz przy starcie aplikacji i że
UmbracoContextjest zarządzany efektywnie. - Środowisko Uruchomieniowe: Upewnij się, że zarówno Twoja aplikacja Web Forms, jak i Umbraco używają tej samej wersji .NET Framework (lub .NET Core dla nowszych Umbraco).
To podejście jest zaawansowane i wymaga dobrej znajomości wewnętrznych mechanizmów Umbraco.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.