Must a Blazor web app only use .razor components?

Falanga, Rod, DOH 245

Very simple question here, so please be gentle with me.

I started a new Blazor app in early November 2024. The last time I worked on it was early December 2024, when several other urgent demands came up and I had to put this app aside until now. I cannot remember exactly what template I chose when creating this app, but it has both CSHTML and Razor files within it. I've run into a problem, so I started looking for solutions. On Stack Overflow I saw an answer to a different question, which left me with the impression that one should NEVER use CSHTML files within a Blazor web app. I thought that using both CSHTML and RAZOR within the same project was fine, so long as when you use a Blazor component it is referenced as a Blazor component. But this person's adamant emphasis that under no circumstances should you use a CSHTML file in a Blazor app has me doubting myself/understanding.

So, basically is this person's assertion that a CSHTML file must never, under any circumstances, be within a Blazor app true?

AgaveJoe 29,866 Reputation points

2025-02-06T00:13:59.58+00:00

You want the community to verify your impression of an SO post that you did not share?

Anyway, CSHTML is Razor Pages. There is no logical reason why a Razor Pages application can't also host Blazor. Can you share the SO post and explain what you are trying to do?
Falanga, Rod, DOH 245 Reputation points

2025-02-06T00:25:33.33+00:00

(Well, here's my first post. Since I can't delete it, I'll leave this meta-comment in.)
Falanga, Rod, DOH 245 Reputation points

2025-02-06T00:36:46.7033333+00:00

I answered your response, AgaveJoe, but it doesn't show up. I've seen this behavior with Microsoft Q&A, where what I write shows up hours later. So, this response may be redundant, I'm sorry about that.

I saw a post on SO, while searching for something else. That's what has prompted my question. I didn't save the URL to the post on SO that I saw, which prompted my question here.

Thank you or your answer, it addresses what I asked. And I'm certainly glad that both Razor pages and Blazor components can coexist in the same app, as I thought they could.
Bruce (SqlWork.com) 71,686 Reputation points

2025-02-06T01:28:32.1633333+00:00

Not the same app, but same website. Blazor is a SPA, which can be hosted by a razor page.. If Blazor call not call a razor page, but redirects to a razor page, and the Blazor app is unloaded.
Tiny Wang-MSFT 3,151 Reputation points Microsoft Vendor

2025-02-07T09:21:33.04+00:00

Hi @Falanga , your concern about a CSHTML file must never, under any circumstances, be within a Blazor app true can be divided into 2 parts, can we use cshtml file in a blazor web app and is it recommend using cshtml into blazor web app if we can use cshtml into blazor web app. I think the answer is yes to Q1 and no to Q2.

I found a github issue which asking help for running razor page in blazor web app. According to the result, it shall be ok. I had a test in my side too with a .Net 8 blazor web app server side render application, but I didn't get it work as expected completely. By the way,we are sure cshtml can be used in blazor server app. Just like you know, we have Layout.cshtml and Error.cshtml in template project.

But for the latest blazor web app template, we don't have official document to show how to run razor pages in blazor web app. If razor page is recommended to be used in Blazor, I trust we will have document for it.
Falanga, Rod, DOH 245 Reputation points

2025-02-07T21:02:20.57+00:00
@Tiny Wang-MSFT I'm replying from my work Microsoft account.

Thank you for the link to that GitHub issue. I already have

app.MapRazorPages();

in my Program.cs. I added the

.WithRazorPagesRoot("/Pages")

to my call to builder.Services.AddRazorPages(), but it didn't make a difference. And I don't think it was necessary anyway; still it was worth a try.

The thing that confuses me is the two CSHTML files that Visual Studio template put in the Pages folder, Index.cshtml and Privacy.cshtml, both work fine and can be found via the navigation, with no problems. However, when I copied the <li> tags in the _Layout.cshtml file to add a link for my CSHTML file, it cannot be found with the navigation.

xxx
Bruce (SqlWork.com) 71,686 Reputation points

2025-02-09T02:08:14.7666667+00:00

Blazor uses JavaScript to intercept link requests and convert to Blazor routing. This means to route to an external razor page (on the same site), you should use Navigation managers NavigateTo() with force reload, which will actually navigate the browser to the new url.

you should not confuse razor pages with blazor components. A blazor app is either a dedicated server thread with a signal/r connection or WASM loaded into the browser.

Share via

Must a Blazor web app only use .razor components?

Your answer