Showing preview only (376K chars total). Download the full file or copy to clipboard to get everything.
Repository: aspnet/Blazor.Docs
Branch: master
Commit: aea3b94c7051
Files: 100
Total size: 345.5 KB
Directory structure:
gitextract_t_iy0_rr/
├── .gitattributes
├── .github/
│ ├── ISSUE_TEMPLATE.md
│ └── PULL_REQUEST_TEMPLATE.md
├── .gitignore
├── CNAME
├── CONTRIBUTING.md
├── LICENSE
├── LICENSE-CODE
├── README.md
├── ThirdPartyNotices
├── api/
│ ├── .gitignore
│ └── index.md
├── appveyor.yml
├── community.md
├── docfx.json
├── docs/
│ ├── common/
│ │ └── samples/
│ │ └── 3.x/
│ │ └── BlazorSample/
│ │ ├── App.cshtml
│ │ ├── BlazorSample.csproj
│ │ ├── Components/
│ │ │ ├── ListViewTemplate.cshtml
│ │ │ ├── Tab.cshtml
│ │ │ ├── TabSet.cshtml
│ │ │ └── TableTemplate.cshtml
│ │ ├── JsInteropClasses/
│ │ │ ├── ExampleJsInterop.cs
│ │ │ └── HelloHelper.cs
│ │ ├── Pages/
│ │ │ ├── BlazorRocks.cshtml
│ │ │ ├── BlazorRocksBase.cs
│ │ │ ├── BlazorRoute.cshtml
│ │ │ ├── CascadingValuesParametersTabSet.cshtml
│ │ │ ├── CascadingValuesParametersTheme.cshtml
│ │ │ ├── ChildComponent.cshtml
│ │ │ ├── FetchData.cshtml
│ │ │ ├── HeadingComponent.cshtml
│ │ │ ├── Index.cshtml
│ │ │ ├── JSInterop.cshtml
│ │ │ ├── ParentComponent.cshtml
│ │ │ ├── RazorTemplates.cshtml
│ │ │ ├── RouteParameter.cshtml
│ │ │ ├── TemplatedComponents.cshtml
│ │ │ └── _ViewImports.cshtml
│ │ ├── Program.cs
│ │ ├── README.md
│ │ ├── Shared/
│ │ │ ├── CascadingValuesParametersLayout.cshtml
│ │ │ ├── MainLayout.cshtml
│ │ │ └── NavMenu.cshtml
│ │ ├── Startup.cs
│ │ ├── UIInterfaces/
│ │ │ └── ITab.cs
│ │ ├── UIThemeClasses/
│ │ │ └── ThemeInfo.cs
│ │ ├── _ViewImports.cshtml
│ │ └── wwwroot/
│ │ ├── css/
│ │ │ └── site.css
│ │ ├── exampleJsInterop.js
│ │ ├── index.html
│ │ └── sample-data/
│ │ └── weather.json
│ ├── component-libraries.md
│ ├── components/
│ │ └── index.md
│ ├── debugging.md
│ ├── dependency-injection.md
│ ├── get-started.md
│ ├── host-and-deploy/
│ │ ├── configure-linker.md
│ │ └── index.md
│ ├── hosting-models/
│ │ └── samples_snapshot/
│ │ └── Startup.cs
│ ├── hosting-models.md
│ ├── index.md
│ ├── introduction/
│ │ ├── faq.md
│ │ └── index.md
│ ├── javascript-interop.md
│ ├── layouts.md
│ ├── routing.md
│ ├── toc.md
│ └── tutorials/
│ ├── build-your-first-blazor-app/
│ │ └── samples/
│ │ └── 3.x/
│ │ └── BlazorApp1/
│ │ ├── App.cshtml
│ │ ├── BlazorApp1.csproj
│ │ ├── Pages/
│ │ │ ├── Counter.cshtml
│ │ │ ├── FetchData.cshtml
│ │ │ ├── Index.cshtml
│ │ │ ├── ToDo.cshtml
│ │ │ └── _ViewImports.cshtml
│ │ ├── Program.cs
│ │ ├── README.md
│ │ ├── Shared/
│ │ │ ├── MainLayout.cshtml
│ │ │ ├── NavMenu.cshtml
│ │ │ └── SurveyPrompt.cshtml
│ │ ├── Startup.cs
│ │ ├── TodoItem.cs
│ │ ├── _ViewImports.cshtml
│ │ └── wwwroot/
│ │ ├── css/
│ │ │ ├── open-iconic/
│ │ │ │ ├── FONT-LICENSE
│ │ │ │ ├── ICON-LICENSE
│ │ │ │ ├── README.md
│ │ │ │ └── font/
│ │ │ │ └── fonts/
│ │ │ │ └── open-iconic.otf
│ │ │ └── site.css
│ │ ├── index.html
│ │ └── sample-data/
│ │ └── weather.json
│ └── build-your-first-blazor-app.md
├── includes/
│ └── razor-components-preview-notice.md
├── index.md
├── releaseDocs.sh
├── src/
│ ├── Microsoft.AspNetCore.Blazor.Browser.xml
│ ├── Microsoft.AspNetCore.Blazor.Server.xml
│ ├── Microsoft.AspNetCore.Blazor.xml
│ └── Microsoft.JSInterop.xml
├── template/
│ ├── index.html.tmpl
│ └── styles/
│ └── main.css
└── toc.yml
================================================
FILE CONTENTS
================================================
================================================
FILE: .gitattributes
================================================
###############################################################################
# Set default behavior to automatically normalize line endings.
###############################################################################
* text=auto
###############################################################################
# Set default behavior for command prompt diff.
#
# This is need for earlier builds of msysgit that does not have it on by
# default for csharp files.
# Note: This is only used by command line
###############################################################################
#*.cs diff=csharp
###############################################################################
# Set the merge driver for project and solution files
#
# Merging from the command prompt will add diff markers to the files if there
# are conflicts (Merging from VS is not affected by the settings below, in VS
# the diff markers are never inserted). Diff markers may cause the following
# file extensions to fail to load in VS. An alternative would be to treat
# these files as binary and thus will always conflict and require user
# intervention with every merge. To do so, just uncomment the entries below
###############################################################################
#*.sln merge=binary
#*.csproj merge=binary
#*.vbproj merge=binary
#*.vcxproj merge=binary
#*.vcproj merge=binary
#*.dbproj merge=binary
#*.fsproj merge=binary
#*.lsproj merge=binary
#*.wixproj merge=binary
#*.modelproj merge=binary
#*.sqlproj merge=binary
#*.wwaproj merge=binary
###############################################################################
# behavior for image files
#
# image files are treated as binary by default.
###############################################################################
#*.jpg binary
#*.png binary
#*.gif binary
*.ico binary
###############################################################################
# diff behavior for common document formats
#
# Convert binary document formats to text before diffing them. This feature
# is only available from the command line. Turn it on by uncommenting the
# entries below.
###############################################################################
#*.doc diff=astextplain
#*.DOC diff=astextplain
#*.docx diff=astextplain
#*.DOCX diff=astextplain
#*.dot diff=astextplain
#*.DOT diff=astextplain
#*.pdf diff=astextplain
#*.PDF diff=astextplain
#*.rtf diff=astextplain
#*.RTF diff=astextplain
================================================
FILE: .github/ISSUE_TEMPLATE.md
================================================
<!--
General
We use issues to drive the discussion for changes to existing topics and the creation of new topics. This template offers some suggestions to consider when creating an issue.
Issues with existing topics
If the issue is a simple typo or similar correction, just submit a PR. Otherwise, let us know what's wrong or what we should improve. Include a link to the topic on the live documentation website.
Requests for new topics
1. Write a short paragraph describing what the topic will cover.
2. Write an outline of the proposed topic contents.
3. Where would you put the topic in the Table of Contents?
4. If you know who should review the issue, notify them by including @githubID in the issue description.
-->
================================================
FILE: .github/PULL_REQUEST_TEMPLATE.md
================================================
<!--
When creating a new PR, please delete this template text and reference the issue number.
To automatically close the issue when the PR is merged, cite the issue number in the first line with ...
Fixes #Issue_Number
To only address an issue with a PR and not automatically close the issue when the PR merges, cite the issue number in the first line with ...
Addresses #Issue_Number
-->
================================================
FILE: .gitignore
================================================
_build/
_site/
Properties/
# Use git add -f to force override .sln when required. Not needed in most cases.
# git add -f myProj.sln
*.sln
Project_Readme.html
## Ignore Visual Studio temporary files, build results, and
## files generated by popular Visual Studio add-ons.
# User-specific files
*.suo
*.user
*.userosscache
*.sln.docstates
*.vscode/
# User-specific files (MonoDevelop/Xamarin Studio)
*.userprefs
# Build results
[Dd]ebug/
[Dd]ebugPublic/
[Rr]elease/
[Rr]eleases/
x64/
x86/
build/
bld/
[Bb]in/
[Oo]bj/
# Visual Studo 2015 cache/options directory
.vs/
# MSTest test Results
[Tt]est[Rr]esult*/
[Bb]uild[Ll]og.*
# NUNIT
*.VisualState.xml
TestResult.xml
# Build Results of an ATL Project
[Dd]ebugPS/
[Rr]eleasePS/
dlldata.c
*_i.c
*_p.c
*_i.h
*.ilk
*.meta
*.obj
*.pch
*.pdb
*.pgc
*.pgd
*.rsp
*.sbr
*.tlb
*.tli
*.tlh
*.tmp
*.tmp_proj
*.log
*.vspscc
*.vssscc
.builds
*.pidb
*.svclog
*.scc
# Chutzpah Test files
_Chutzpah*
# Visual C++ cache files
ipch/
*.aps
*.ncb
*.opensdf
*.sdf
*.cachefile
# Visual Studio profiler
*.psess
*.vsp
*.vspx
# TFS 2012 Local Workspace
$tf/
# Guidance Automation Toolkit
*.gpState
# ReSharper is a .NET coding add-in
_ReSharper*/
*.[Rr]e[Ss]harper
*.DotSettings.user
# JustCode is a .NET coding addin-in
.JustCode
# TeamCity is a build add-in
_TeamCity*
# DotCover is a Code Coverage Tool
*.dotCover
# NCrunch
_NCrunch_*
.*crunch*.local.xml
# MightyMoose
*.mm.*
AutoTest.Net/
# Web workbench (sass)
.sass-cache/
# Installshield output folder
[Ee]xpress/
# DocProject is a documentation generator add-in
DocProject/buildhelp/
DocProject/Help/*.HxT
DocProject/Help/*.HxC
DocProject/Help/*.hhc
DocProject/Help/*.hhk
DocProject/Help/*.hhp
DocProject/Help/Html2
DocProject/Help/html
# Click-Once directory
publish/
# Publish Web Output
*.[Pp]ublish.xml
*.azurePubxml
# TODO: Comment the next line if you want to checkin your web deploy settings
# but database connection strings (with potential passwords) will be unencrypted
*.pubxml
*.publishproj
# NuGet Packages
*.nupkg
# The packages folder can be ignored because of Package Restore
**/packages/*
# except build/, which is used as an MSBuild target.
!**/packages/build/
# Uncomment if necessary however generally it will be regenerated when needed
#!**/packages/repositories.config
# Windows Azure Build Output
csx/
*.build.csdef
# Windows Store app package directory
AppPackages/
# Others
*.[Cc]ache
ClientBin/
[Ss]tyle[Cc]op.*
~$*
*~
*.dbmdl
*.dbproj.schemaview
*.pfx
*.publishsettings
node_modules/
bower_components/
# RIA/Silverlight projects
Generated_Code/
# Backup & report files from converting an old project file
# to a newer Visual Studio version. Backup files are not needed,
# because we have git ;-)
_UpgradeReport_Files/
Backup*/
UpgradeLog*.XML
UpgradeLog*.htm
# SQL Server files
*.mdf
*.ldf
# Business Intelligence projects
*.rdl.data
*.bim.layout
*.bim_*.settings
# Microsoft Fakes
FakesAssemblies/
# Node.js Tools for Visual Studio
.ntvs_analysis.dat
# Visual Studio 6 build log
*.plg
# Visual Studio 6 workspace options file
*.opt
project.lock.json
**/sample/**/wwwroot/lib/
**/samples/**/wwwroot/lib/
__pycache__/
#Mac OSX
.DS_Store
# Windows thumbnail cache files
Thumbs.db
# DocFx
api/.manifest
_exported_templates/
================================================
FILE: CNAME
================================================
blazor.net
================================================
FILE: CONTRIBUTING.md
================================================
# Contributing to the Blazor documentation
This document covers the process for contributing to the articles and code samples that are hosted at http://blazor.net. Contributions may be as simple as typo corrections or as complex as new articles.
## How to make a simple correction or suggestion
Articles are stored in the repository as markdown files. Simple changes to the content of a markdown file can be made in the browser by selecting the **Improve this Doc** link in the upper-right corner of the browser window, editing the doc on GitHub, and then submitting a pull request (PR) for the change. We will review the PR and accept it or suggest changes.
## How to make a more complex submission
You'll need a basic understanding of [Git and GitHub.com](https://guides.github.com/activities/hello-world/).
* Open an [issue](https://github.com/aspnet/Blazor.Docs/issues/new) describing what you want to do, such as change an existing article or create a new one. Wait for approval from the team before you invest much time. We usually request an outline for a new topic proposal.
* Fork the [aspnet/Blazor.Docs](https://github.com/aspnet/Blazor.Docs/) repo and create a branch for your changes.
* Submit a pull request (PR) to master with your changes.
* If your PR has the label 'cla-required' assigned, [complete the Contribution License Agreement (CLA)](https://cla.dotnetfoundation.org/)
* Respond to PR feedback.
## Markdown syntax
Articles are written in [DocFx-flavored Markdown (DFM)](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html), which is a superset of [GitHub-flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). For examples of DFM syntax for UI features commonly used in the Blazor documentation, see [Metadata and Markdown Template](https://github.com/dotnet/docs/blob/master/styleguide/template.md) in the .NET repo style guide.
## Folder structure conventions
For each markdown file, there may be a folder for images and a folder for sample code. For example, if the article is *tutorials/build-your-first-blazor-app.md*, the images are in *tutorials/build-your-first-blazor-app/\_static* and the sample app project files are in *tutorials/build-your-first-blazor-app/samples/2.x* (for a 2.x versioned sample). An image in the *tutorials/build-your-first-blazor-app.md* file is rendered by the following markdown.
```
```
**All** images should have [alt text](https://wikipedia.org/wiki/Alt_attribute).
Markdown file names and image file names should be all lower case. Use dashes to separate words in file names.
## Internal links
Internal links should use the `uid` of the target article with an xref link:
```
[link_text](xref:uid_of_the_topic)
```
For more informatin, see the [DocFX Cross Reference](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#cross-reference).
## Code snippets
Articles frequently contain code snippets to illustrate points. DFM lets you copy code into the Markdown file or refer to a separate code file. We prefer to use separate code files whenever possible to minimize the chance of errors in the code. The code files should be stored in the repo using the folder structure described above for sample projects.
Here are some examples of [DFM code snippet syntax](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#code-snippet) that would be used in a *tutorials/build-your-first-blazor-app.md* file.
To render an entire code file as a snippet:
```
[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs)]
```
To render a portion of a file as a snippet by using line numbers:
```
[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?range=1-10,20,30,40-50]
[!code-html[Main](tutorials/build-your-first-blazor-app/sample/Pages/Index.cshtml?range=1-10,20,30,40-50]
```
For C# snippets, you can reference a [C# region](https://docs.microsoft.com/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-region). Whenever possible, use regions rather than line numbers because line numbers in a code file tend to change and become out of sync with line number references in markdown. C# regions can be nested; and if you reference the outer region, the inner `#region` and `#endregion` directives aren't rendered in a snippet.
To render a C# region named "snippet_Example":
```
[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?name=snippet_Example)]
```
To highlight selected lines in a rendered snippet (usually renders as yellow background color):
```
[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?name=snippet_Example&highlight=1-3,10,20-25)]
[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?range=10-20&highlight=1-3]
[!code-html[Main](tutorials/build-your-first-blazor-app/sample/Pages/Index.cshtml?range=10-20&highlight=1-3]
[!code-javascript[Main](tutorials/build-your-first-blazor-app/sample/BlazorApp1.csproj?range=10-20&highlight=1-3]
```
## Test your changes with DocFX
Test your changes with the [DocFX command-line tool](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html#2-use-docfx-as-a-command-line-tool), which creates a locally-hosted version of the site. DocFX doesn't render style and site extensions created for docs.microsoft.com.
DocFX requires the .NET Framework on Windows or Mono for Linux/macOS.
### Windows instructions
* Download and unzip *docfx.zip* from [DocFX releases](https://github.com/dotnet/docfx/releases).
* Add DocFX to your PATH.
* In a console window, navigate to root of the repo (where the *docfx.json* file resides) and run the following command:
```
docfx --serve
```
* In a browser, navigate to `http://localhost:8080`.
### Mono instructions
* Install Mono via Homebrew:
```
brew install mono
```
* Download the [latest version of DocFX](https://github.com/dotnet/docfx/releases).
* Extract the archive to *$HOME/bin/docfx*.
* Create a pair of aliases for **docfx** in a bash shell. The first alias is used to build the documentation. The second alias is used to build and serve the documentation.
```
alias docfx='mono $HOME/bin/docfx/docfx.exe'
alias docfx-serve='mono $HOME/bin/docfx/docfx.exe --serve'
```
* Execute `docfx` from the root of the repo to build the site. Execute `docfx-serve` to view the site at `http://localhost:8080`.
## Voice and tone
Our goal is to write documentation that is easily understandable by the widest possible audience. To that end, we've established guidelines for writing style that we ask our contributors to follow. For more information, see [Voice and tone guidelines](https://github.com/dotnet/docs/blob/master/styleguide/voice-tone.md) in the .NET repo.
## Microsoft Writing Style Guide
The [Microsoft Writing Style Guide](https://docs.microsoft.com/style-guide/welcome/) provides writing style and terminology guidance for all forms of technology communication, including the Blazor documentation.
================================================
FILE: LICENSE
================================================
Attribution 4.0 International
=======================================================================
Creative Commons Corporation ("Creative Commons") is not a law firm and
does not provide legal services or legal advice. Distribution of
Creative Commons public licenses does not create a lawyer-client or
other relationship. Creative Commons makes its licenses and related
information available on an "as-is" basis. Creative Commons gives no
warranties regarding its licenses, any material licensed under their
terms and conditions, or any related information. Creative Commons
disclaims all liability for damages resulting from their use to the
fullest extent possible.
Using Creative Commons Public Licenses
Creative Commons public licenses provide a standard set of terms and
conditions that creators and other rights holders may use to share
original works of authorship and other material subject to copyright
and certain other rights specified in the public license below. The
following considerations are for informational purposes only, are not
exhaustive, and do not form part of our licenses.
Considerations for licensors: Our public licenses are
intended for use by those authorized to give the public
permission to use material in ways otherwise restricted by
copyright and certain other rights. Our licenses are
irrevocable. Licensors should read and understand the terms
and conditions of the license they choose before applying it.
Licensors should also secure all rights necessary before
applying our licenses so that the public can reuse the
material as expected. Licensors should clearly mark any
material not subject to the license. This includes other CC-
licensed material, or material used under an exception or
limitation to copyright. More considerations for licensors:
wiki.creativecommons.org/Considerations_for_licensors
Considerations for the public: By using one of our public
licenses, a licensor grants the public permission to use the
licensed material under specified terms and conditions. If
the licensor's permission is not necessary for any reason--for
example, because of any applicable exception or limitation to
copyright--then that use is not regulated by the license. Our
licenses grant only permissions under copyright and certain
other rights that a licensor has authority to grant. Use of
the licensed material may still be restricted for other
reasons, including because others have copyright or other
rights in the material. A licensor may make special requests,
such as asking that all changes be marked or described.
Although not required by our licenses, you are encouraged to
respect those requests where reasonable. More_considerations
for the public:
wiki.creativecommons.org/Considerations_for_licensees
=======================================================================
Creative Commons Attribution 4.0 International Public License
By exercising the Licensed Rights (defined below), You accept and agree
to be bound by the terms and conditions of this Creative Commons
Attribution 4.0 International Public License ("Public License"). To the
extent this Public License may be interpreted as a contract, You are
granted the Licensed Rights in consideration of Your acceptance of
these terms and conditions, and the Licensor grants You such rights in
consideration of benefits the Licensor receives from making the
Licensed Material available under these terms and conditions.
Section 1 -- Definitions.
a. Adapted Material means material subject to Copyright and Similar
Rights that is derived from or based upon the Licensed Material
and in which the Licensed Material is translated, altered,
arranged, transformed, or otherwise modified in a manner requiring
permission under the Copyright and Similar Rights held by the
Licensor. For purposes of this Public License, where the Licensed
Material is a musical work, performance, or sound recording,
Adapted Material is always produced where the Licensed Material is
synched in timed relation with a moving image.
b. Adapter's License means the license You apply to Your Copyright
and Similar Rights in Your contributions to Adapted Material in
accordance with the terms and conditions of this Public License.
c. Copyright and Similar Rights means copyright and/or similar rights
closely related to copyright including, without limitation,
performance, broadcast, sound recording, and Sui Generis Database
Rights, without regard to how the rights are labeled or
categorized. For purposes of this Public License, the rights
specified in Section 2(b)(1)-(2) are not Copyright and Similar
Rights.
d. Effective Technological Measures means those measures that, in the
absence of proper authority, may not be circumvented under laws
fulfilling obligations under Article 11 of the WIPO Copyright
Treaty adopted on December 20, 1996, and/or similar international
agreements.
e. Exceptions and Limitations means fair use, fair dealing, and/or
any other exception or limitation to Copyright and Similar Rights
that applies to Your use of the Licensed Material.
f. Licensed Material means the artistic or literary work, database,
or other material to which the Licensor applied this Public
License.
g. Licensed Rights means the rights granted to You subject to the
terms and conditions of this Public License, which are limited to
all Copyright and Similar Rights that apply to Your use of the
Licensed Material and that the Licensor has authority to license.
h. Licensor means the individual(s) or entity(ies) granting rights
under this Public License.
i. Share means to provide material to the public by any means or
process that requires permission under the Licensed Rights, such
as reproduction, public display, public performance, distribution,
dissemination, communication, or importation, and to make material
available to the public including in ways that members of the
public may access the material from a place and at a time
individually chosen by them.
j. Sui Generis Database Rights means rights other than copyright
resulting from Directive 96/9/EC of the European Parliament and of
the Council of 11 March 1996 on the legal protection of databases,
as amended and/or succeeded, as well as other essentially
equivalent rights anywhere in the world.
k. You means the individual or entity exercising the Licensed Rights
under this Public License. Your has a corresponding meaning.
Section 2 -- Scope.
a. License grant.
1. Subject to the terms and conditions of this Public License,
the Licensor hereby grants You a worldwide, royalty-free,
non-sublicensable, non-exclusive, irrevocable license to
exercise the Licensed Rights in the Licensed Material to:
a. reproduce and Share the Licensed Material, in whole or
in part; and
b. produce, reproduce, and Share Adapted Material.
2. Exceptions and Limitations. For the avoidance of doubt, where
Exceptions and Limitations apply to Your use, this Public
License does not apply, and You do not need to comply with
its terms and conditions.
3. Term. The term of this Public License is specified in Section
6(a).
4. Media and formats; technical modifications allowed. The
Licensor authorizes You to exercise the Licensed Rights in
all media and formats whether now known or hereafter created,
and to make technical modifications necessary to do so. The
Licensor waives and/or agrees not to assert any right or
authority to forbid You from making technical modifications
necessary to exercise the Licensed Rights, including
technical modifications necessary to circumvent Effective
Technological Measures. For purposes of this Public License,
simply making modifications authorized by this Section 2(a)
(4) never produces Adapted Material.
5. Downstream recipients.
a. Offer from the Licensor -- Licensed Material. Every
recipient of the Licensed Material automatically
receives an offer from the Licensor to exercise the
Licensed Rights under the terms and conditions of this
Public License.
b. No downstream restrictions. You may not offer or impose
any additional or different terms or conditions on, or
apply any Effective Technological Measures to, the
Licensed Material if doing so restricts exercise of the
Licensed Rights by any recipient of the Licensed
Material.
6. No endorsement. Nothing in this Public License constitutes or
may be construed as permission to assert or imply that You
are, or that Your use of the Licensed Material is, connected
with, or sponsored, endorsed, or granted official status by,
the Licensor or others designated to receive attribution as
provided in Section 3(a)(1)(A)(i).
b. Other rights.
1. Moral rights, such as the right of integrity, are not
licensed under this Public License, nor are publicity,
privacy, and/or other similar personality rights; however, to
the extent possible, the Licensor waives and/or agrees not to
assert any such rights held by the Licensor to the limited
extent necessary to allow You to exercise the Licensed
Rights, but not otherwise.
2. Patent and trademark rights are not licensed under this
Public License.
3. To the extent possible, the Licensor waives any right to
collect royalties from You for the exercise of the Licensed
Rights, whether directly or through a collecting society
under any voluntary or waivable statutory or compulsory
licensing scheme. In all other cases the Licensor expressly
reserves any right to collect such royalties.
Section 3 -- License Conditions.
Your exercise of the Licensed Rights is expressly made subject to the
following conditions.
a. Attribution.
1. If You Share the Licensed Material (including in modified
form), You must:
a. retain the following if it is supplied by the Licensor
with the Licensed Material:
i. identification of the creator(s) of the Licensed
Material and any others designated to receive
attribution, in any reasonable manner requested by
the Licensor (including by pseudonym if
designated);
ii. a copyright notice;
iii. a notice that refers to this Public License;
iv. a notice that refers to the disclaimer of
warranties;
v. a URI or hyperlink to the Licensed Material to the
extent reasonably practicable;
b. indicate if You modified the Licensed Material and
retain an indication of any previous modifications; and
c. indicate the Licensed Material is licensed under this
Public License, and include the text of, or the URI or
hyperlink to, this Public License.
2. You may satisfy the conditions in Section 3(a)(1) in any
reasonable manner based on the medium, means, and context in
which You Share the Licensed Material. For example, it may be
reasonable to satisfy the conditions by providing a URI or
hyperlink to a resource that includes the required
information.
3. If requested by the Licensor, You must remove any of the
information required by Section 3(a)(1)(A) to the extent
reasonably practicable.
4. If You Share Adapted Material You produce, the Adapter's
License You apply must not prevent recipients of the Adapted
Material from complying with this Public License.
Section 4 -- Sui Generis Database Rights.
Where the Licensed Rights include Sui Generis Database Rights that
apply to Your use of the Licensed Material:
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
to extract, reuse, reproduce, and Share all or a substantial
portion of the contents of the database;
b. if You include all or a substantial portion of the database
contents in a database in which You have Sui Generis Database
Rights, then the database in which You have Sui Generis Database
Rights (but not its individual contents) is Adapted Material; and
c. You must comply with the conditions in Section 3(a) if You Share
all or a substantial portion of the contents of the database.
For the avoidance of doubt, this Section 4 supplements and does not
replace Your obligations under this Public License where the Licensed
Rights include other Copyright and Similar Rights.
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
c. The disclaimer of warranties and limitation of liability provided
above shall be interpreted in a manner that, to the extent
possible, most closely approximates an absolute disclaimer and
waiver of all liability.
Section 6 -- Term and Termination.
a. This Public License applies for the term of the Copyright and
Similar Rights licensed here. However, if You fail to comply with
this Public License, then Your rights under this Public License
terminate automatically.
b. Where Your right to use the Licensed Material has terminated under
Section 6(a), it reinstates:
1. automatically as of the date the violation is cured, provided
it is cured within 30 days of Your discovery of the
violation; or
2. upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any
right the Licensor may have to seek remedies for Your violations
of this Public License.
c. For the avoidance of doubt, the Licensor may also offer the
Licensed Material under separate terms or conditions or stop
distributing the Licensed Material at any time; however, doing so
will not terminate this Public License.
d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
License.
Section 7 -- Other Terms and Conditions.
a. The Licensor shall not be bound by any additional or different
terms or conditions communicated by You unless expressly agreed.
b. Any arrangements, understandings, or agreements regarding the
Licensed Material not stated herein are separate from and
independent of the terms and conditions of this Public License.
Section 8 -- Interpretation.
a. For the avoidance of doubt, this Public License does not, and
shall not be interpreted to, reduce, limit, restrict, or impose
conditions on any use of the Licensed Material that could lawfully
be made without permission under this Public License.
b. To the extent possible, if any provision of this Public License is
deemed unenforceable, it shall be automatically reformed to the
minimum extent necessary to make it enforceable. If the provision
cannot be reformed, it shall be severed from this Public License
without affecting the enforceability of the remaining terms and
conditions.
c. No term or condition of this Public License will be waived and no
failure to comply consented to unless expressly agreed to by the
Licensor.
d. Nothing in this Public License constitutes or may be interpreted
as a limitation upon, or waiver of, any privileges and immunities
that apply to the Licensor or You, including from the legal
processes of any jurisdiction or authority.
=======================================================================
Creative Commons is not a party to its public
licenses. Notwithstanding, Creative Commons may elect to apply one of
its public licenses to material it publishes and in those instances
will be considered the “Licensor.” The text of the Creative Commons
public licenses is dedicated to the public domain under the CC0 Public
Domain Dedication. Except for the limited purpose of indicating that
material is shared under a Creative Commons public license or as
otherwise permitted by the Creative Commons policies published at
creativecommons.org/policies, Creative Commons does not authorize the
use of the trademark "Creative Commons" or any other trademark or logo
of Creative Commons without its prior written consent including,
without limitation, in connection with any unauthorized modifications
to any of its public licenses or any other arrangements,
understandings, or agreements concerning use of licensed material. For
the avoidance of doubt, this paragraph does not form part of the
public licenses.
Creative Commons may be contacted at creativecommons.org.
================================================
FILE: LICENSE-CODE
================================================
The MIT License (MIT)
Copyright (c) Microsoft Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
================================================
FILE: README.md
================================================
# Blazor Docs
The Blazor docs have moved to the https://github.com/aspnet/AspNetCore.Docs repo and are published at https://docs.microsoft.com/en-us/aspnet/core/blazor.
For an overview of the many projects being worked on by the Blazor community page check out the [Awesome Blazor](https://github.com/AdrienTorris/awesome-blazor) page.
================================================
FILE: ThirdPartyNotices
================================================
##Legal Notices
Microsoft and any contributors grant you a license to the Microsoft documentation and other content
in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),
see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the
[LICENSE-CODE](LICENSE-CODE) file.
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation
may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
Privacy information can be found at https://privacy.microsoft.com/en-us/
Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents,
or trademarks, whether by implication, estoppel or otherwise.
================================================
FILE: api/.gitignore
================================================
###############
# temp file #
###############
*.yml
================================================
FILE: api/index.md
================================================
---
title: Blazor API
description: Find information on the Blazor API.
uid: api
---
# Blazor API
[!INCLUDE[](~/includes/razor-components-preview-notice.md)]
Welcome to the Blazor API area!
## Namespaces
Use the namespace links in the Table of Contents.
================================================
FILE: appveyor.yml
================================================
skip_tags: true
image: Visual Studio 2017
clone_depth: 1
branches:
only:
- live
install:
- cinst docfx --version 2.40.7
build_script:
- docfx
deploy_script:
- git config --global credential.helper store
- ps: Add-Content "$env:USERPROFILE\.git-credentials" "https://$($env:GITHUB_ACCESS_TOKEN):x-oauth-basic@github.com`n"
- git config --global user.email %GITHUB_EMAIL%
- git config --global user.name "Blazor doc agent"
- bash releaseDocs.sh
================================================
FILE: community.md
================================================
# Blazor community resources
[!INCLUDE[](~/includes/razor-components-preview-notice.md)]
Below is a list of projects and resources from the Blazor community (links in each section are alphabetical). If you know about a Blazor project that isn't listed, please let us know. We're happy to add it to the list.
## Libraries
* [BlazorBits](http://blazorbits.net) ([GitHub repo](https://github.com/blazorbits)) – Components including [Monaco editor](https://github.com/Microsoft/monaco-editor).
* [BlazorComponents](https://github.com/muqeet-khan/BlazorComponents) – A demonstration of [Chart.js](https://github.com/chartjs/Chart.js) interop.
* [BlazorConfirm](https://github.com/ctrl-alt-d/BlazorConfirm) ([Demo](https://ctrl-alt-d.github.io/BlazorConfirm/)) – A Blazor wrapper for JavaScript's `window.confirm()` and `onbeforeunload`.
* [BlazorContextMenu](https://github.com/stavroskasidis/BlazorContextMenu) – A context menu for blazor.
* [BlazorDB](https://github.com/chanan/BlazorDB) – In-memory, persisted to local storage, database for Blazor.
* [Blazored.LocalStorage](https://github.com/blazored/LocalStorage) – A library to provide access to local storage in Blazor apps.
* [Blazored.Menu](https://github.com/Blazored/Menu) – A JavaScript-free menu library for Blazor and Razor Components apps.
* [Blazored.Modal](https://github.com/Blazored/Modal) – A JavaScript free modal library for Blazor and Razor Components applications.
* [Blazored.Toast](https://github.com/Blazored/Toast) – A JavaScript free toast library for Blazor and Razor Component applications.
* [Blazored.Localisation](https://github.com/Blazored/Localisation) – A library to provide localisation in client-side Blazor applications.
* [BlazorEmbedLibrary](https://github.com/SQL-MisterMagoo/BlazorEmbedLibrary) – Provides Blazor-style embedded resources to Razor Components projects.
* [BlazorWebSocketHelper](https://github.com/Lupusa87/BlazorWebSocketHelper) – A WebSocket library for Blazor.
* [BlazorGrid](https://github.com/AnkitSharma-007/BlazorGrid) – Reusable grid component for Blazor, which also supports client side pagination.
* [Blazorise](https://github.com/stsrki/Blazorise) ([Demo](https://bootstrapdemo.blazorise.com/)) – Components library for Blazor with support for Bootstrap, Bulma, and Material CSS.
* [BlazorMaterial](https://github.com/BlazorExtensions/BlazorMaterial) – Blazor components implementing Google's Material components for web ([Material Design: Web](https://material.io/components/web)).
* [BlazorNodaTimeDateTimePicker](https://github.com/nheath99/BlazorNodaTimeDateTimePicker) – A date picker using NodaTime.
* [Blazorous](https://github.com/chanan/Blazorous) – Maintainable CSS with Blazor.
* [BlazorScrollbar](https://github.com/Lupusa87/BlazorScrollbar) ([Demo](https://lupblazorscrollbar.z20.web.core.windows.net/)) – Reusable, fully configurable component with vertical and horizontal scrollbars.
* [BlazorSignalR](https://github.com/csnewman/BlazorSignalR) – ASP.NET Core SignalR .NET client support for Blazor.
* [BlazorSplit](https://github.com/BlazorComponents/BlazorSplit) ([Demo](https://blazorcomponents.github.io/BlazorSplit/)) – Resizeable split views.
* [BlazorSplitter](https://github.com/Lupusa87/BlazorSplitter) ([Demo](https://lupblazorsplitter.z20.web.core.windows.net/)) – Reusable, fully configurable component with vertical and horizontal splitters and diagonal resizer.
* [BlazorStorage](https://github.com/cloudcrate/BlazorStorage) – Blazor local and session storage support.
* [BlazorStrap](https://github.com/chanan/BlazorStrap) – Bootstrap 4 Components for Blazor.
* [BlazorTodos](https://lupblazortodo.z20.web.core.windows.net/) – Blazor todos demo app with registration, jwt authentication, email reminders and more, backed with Azure Storage Tables.
* [BlazorVirtualGrid](https://github.com/Lupusa87/BlazorVirtualGrid) ([Demo](https://lupblazorvirtualgrid.z13.web.core.windows.net/)) – Reusable, fully configurable component with rows and columns fast virtualization.
* [Blazor Barcode](https://barcoderesource.com/blazorbarcode.shtml) – A barcode library for Blazor using barcode fonts.
* [Blazor Charts](https://github.com/Misfits-Rebels-Outcasts/Blazor-Charts) – SVG Charts for Blazor.
* [Blazor Extensions Home](https://github.com/BlazorExtensions/Home) – Home for Blazor Extensions.
* [Blazor Fluxor](https://mrpmorris.github.io/blazor-fluxor/) – Flux/Redux library.
* [Blazor Gamepad](https://github.com/jsakamoto/Toolbelt.Blazor.Gamepad) – A library to provide gamepad API access for Blazor.
* [Blazor Hotkeys](https://github.com/jsakamoto/Toolbelt.Blazor.Hotkeys) – A library to provide configuration-centric keyboard shortcuts for Blazor.
* [Blazor LoadingBar](https://github.com/jsakamoto/Toolbelt.Blazor.LoadingBar) – A Blazor port of [angular-loading-bar](https://github.com/chieffancypants/angular-loading-bar).
* [Blazor LocalFiles](https://github.com/jburman/W8lessLabs.Blazor.LocalFiles) – Open files in your browser and load into Blazor.
* [Blazor Realm](https://dworthen.github.io/BlazorRealm/docs/quickstart.html) – Redux state management with middleware support.
* [Blazor Redux](https://github.com/torhovland/blazor-redux) – This library offers Redux-style state management for Blazor.
* [Blazor SpeechSynthesis](https://github.com/jsakamoto/Toolbelt.Blazor.SpeechSynthesis) – A library to provide Speech Synthesis API access for Blazor.
* [Blazor SVG Helper](https://github.com/Lupusa87/BlazorSvgHelper) ([Demo](https://lupblazordemos.z13.web.core.windows.net)) – Create SVG elements with children (circle, rectangle, image, text, and others) and render with RenderTreeBuilder.
* [Blazor Time Zone Kit](https://github.com/jsakamoto/Toolbelt.Blazor.TimeZoneKit) – A library to provide system time zones and local time zone initialization in Blazor apps.
* [Blazor Tweet Button](https://github.com/jsakamoto/Toolbelt.Blazor.TwitterShareButton) – A Tweet Button component for Blazor.
* [Blazor.Extensions.OfficeUIFabric](https://github.com/BlazorExtensions/Blazor.Extensions.OfficeUIFabric) – Microsoft Office Fabric UI port for Blazor.
* [Blazor.FlexGrid](https://github.com/Mewriick/Blazor.FlexGrid) – GridView component for Blazor.
* [Blazor.Payments](https://github.com/philipblaquiere/Blazor.Payments) – A library that replicates the [W3C Payment Request API](https://w3c.github.io/payment-request/) contracts in Blazor apps.
* [Blazor.Polyfill](https://github.com/Daddoon/Blazor.Polyfill) – A Blazor compatibility library for Internet Explorer 11 and other browsers.
* [Blazor.Xamarin](https://github.com/Daddoon/Blazor.Xamarin) – Host Blazor apps as standalone hybrid mobile apps with Xamarin.
* [Blazor-State](https://timewarpengineering.github.io/blazor-state/) – Blazor-State is a client side pipeline architecture utilizing MediatR with plugin behaviors.
* [Canvas](https://github.com/BlazorExtensions/Canvas) – HTML5 Canvas API implementation for Microsoft Blazor.
* [ChartJs.Blazor](https://github.com/mariusmuntean/ChartJs.Blazor) – Blazor Component that wraps ChartJS.
* [DevExpress Blazor UI Components](https://github.com/DevExpress/RazorComponents) – UI components including Data Grid, Pivot Grid, and several data editors.
* [Elmah.Io.Blazor](https://github.com/elmahio/Elmah.Io.Blazor) – Logs from Blazor to [elmah.io](https://elmah.io/) using Microsoft.Extensions.Logging.
* [Logging](https://github.com/BlazorExtensions/Logging) – Microsoft Extension Logging implementation for Blazor.
* [MatBlazor](https://github.com/BlazorComponents/MatBlazor) ([Demo](https://blazorcomponents.github.io/MatBlazor/)) – Google Material components for web in Blazor.
* [NObservable](https://github.com/kekekeks/NObservable) – MobX-like observables and component instrumentation.
* [Notifications](https://github.com/BlazorExtensions/Notifications) – HTML5 Notifications API implementation for Microsoft Blazor.
* [SignalR](https://github.com/BlazorExtensions/SignalR) – SignalR Core support for Microsoft ASP.NET Core Blazor.
* [Sotsera.Blazor.Toaster](https://github.com/sotsera/sotsera.blazor.toaster) ([Demo](https://sotsera.github.io/sotsera.blazor.toaster/)) – A Blazor port of [Toastr.js](https://github.com/CodeSeven/toastr/).
* [Storage](https://github.com/BlazorExtensions/Storage) – HTML5 Storage API implementation for Microsoft Blazor.
* [Syncfusion Blazor UI Components](https://github.com/syncfusion/ej2-aspnet-core-blazor-samples) – A complete library of robust UI components including [Data Grid](https://ej2.syncfusion.com/aspnet-core-razor-components/Grid/DefaultFunctionalities), [Charts](https://ej2.syncfusion.com/aspnet-core-razor-components/Charts/polar), [Scheduler](https://ej2.syncfusion.com/aspnet-core-razor-components/Schedule/TimelineResourceGroup), [Inputs](https://ej2.syncfusion.com/aspnet-core-razor-components/TextBox/DefaultFunctionalities), and various [Editor](https://ej2.syncfusion.com/aspnet-core-razor-components/RichTextEditor/DefaultFunctionalities) components.
* [Telerik UI for Blazor](https://www.telerik.com/blazor-ui) – A native set of UI components for Blazor, including grid, charting, and calendar components.
* [Toastr](https://github.com/BlazorExtensions/Toastr) – A Blazor port of [Toastr.js](https://github.com/CodeSeven/toastr/).
## Samples and tutorials
* [A Nicer Looking Blazor Loading Page](http://lightswitchhelpwebsite.com/Blog/tabid/61/EntryId/4315/A-Nicer-Looking-Blazor-Loading-Page.aspx) – Customize the Blazor loading page using [SpinKit](https://github.com/tobiasahlin/SpinKit).
* [ASP.NET Core Master/Detail CRUD](https://code.msdn.microsoft.com/vstudio/ASPNET-Core-Blazor-122b108a) – A master/detail HTML CRUD example with sorting and filtering using Entity Framework and Web API.
* [BlazeDown](https://github.com/EdCharbeneau/BlazeDown) ([Demo](http://edcharbeneau.com/BlazeDown/)) – An online markdown editor built with Blazor.
* [Blazing Chuck](https://davidpine.net/blog/blazing-chuck/) ([Demo](https://bit.ly/BlazingChuck)) – An example Blazor app that displays random "nerdy" Chuck Norris jokes.
* [BlazorPass](https://github.com/ebekker/BlazorPass) – Blazor UI and ASP.NET Core API to manage Active Directory credentials.
* [Blazor + Electron sample](https://github.com/aspnet/AspLabs/tree/master/src/ComponentsElectron) – Explore how a Blazor app can be used to build a cross-platform desktop app.
* [Blazor + Sitecore](https://github.com/GoranHalvarsson/SitecoreBlazor) ([Blog post](https://visionsincode.wordpress.com/2018/06/30/time-travel-into-the-future-blazor-sitecore-helix/)) – Example of dynamic pages and routes with SiteCore and [Helix](https://helix.sitecore.net/).
* [Blazor Admin Dashboard](https://github.com/Misfits-Rebels-Outcasts/Blazor-Dashboard) – An admin dashboard for Blazor.
* [Blazor Asteroids](https://github.com/aesalazar/AsteroidsWasm) ([Demo](https://aesalazar.github.io/AsteroidsWasm/)) – The 80's classic video game developed in C# for WinForms/WPF but running Blazor.
* [Blazor Bricks](https://www.codeproject.com/Articles/1241210/WebAssembly-with-Blazor) – A bricks game developed with C# and Blazor.
* [Blazor Calculator](https://github.com/Lupusa87/BlazorCalculator) ([Demo](https://lupblazordemos.z13.web.core.windows.net/CalculatorPage)) – Simple calculator with history and ability to use previous results in new calculations.
* [Blazor Calculator with Expressions](https://github.com/khaledmousa/BlazorCalculator) ([Demo](https://khaledmousa.github.io/)) – A sample numerical expression evaluator in Blazor utilizing an F# library that uses FsLex and FsYacc to parse expressions.
* [Blazor Chat sample](https://github.com/conficient/BlazorChatSample) ([Demo](https://blazorchatsample.azurewebsites.net/)) – An app that demonstrates the use of [SignalR](https://docs.microsoft.com/aspnet/core/signalr/) to create a Blazor chat app.
* [Blazor Chess](https://github.com/Lupusa87/BlazorChess) ([Demo](https://lupblazordemos.z13.web.core.windows.net/ChessPage)) – An experimental Blazor chess engine.
* [Blazor Clock Canvas](https://github.com/Lupusa87/BlazorClockCanvas) ([Demo](https://lupblazordemos.z13.web.core.windows.net/ClockCanvas)) – Complex clock based on Canvas.
* [Blazor Clock SVG](https://github.com/Lupusa87/BlazorClockSVG) ([Demo](https://lupblazordemos.z13.web.core.windows.net/)) – Complex clock based on SVG.
* [Blazor Contoso University](https://github.com/lohithgn/blazor-contoso-university) – Contoso University recreated in Blazor.
* [Blazor Converters](https://github.com/lohithgn/blazor-converters) ([Demo](http://blazorconverters.surge.sh)) – Windows 10 Calc Converters recreated in Blazor.
* [Blazor Doughnut Chart](https://github.com/Lupusa87/BlazorDoughnutChartComponent) ([Demo](https://lupblazordemos.z13.web.core.windows.net/DoughnutChartpage)) – Doughnut charting with gradient colors using SVG.
* [Blazor Examples](https://github.com/lohithgn/blazor-examples) ([Demo](http://blazorexamples.surge.sh/)) – Knockout JS examples recreated in Blazor.
* [Blazor Game Snake](https://github.com/Lupusa87/BlazorGameSnake) ([Demo](https://lupblazordemos.z13.web.core.windows.net/GameSnakePage)) – 2D game snake with customizations, path finding algorithm, and sound effects using SVG.
* [Blazor Graph API example](https://github.com/jburman/BlazorGraphExample) ([Demo](https://blazorgraph.z20.web.core.windows.net/)) – A self-contained Blazor app that connects to [Microsoft's Graph API](https://docs.microsoft.com/azure/active-directory/develop/active-directory-graph-api), queries the user's information, and allows the user to browse through their [OneDrive](https://onedrive.live.com/about/).
* [Blazor Hacker News Clone](https://github.com/lohithgn/blazor-hackernews-clone) ([Demo](http://blazorhackernews.surge.sh/)) – A Hacker News clone built in Blazor.
* [Blazor Loan Calculator](https://github.com/Lupusa87/BlazorLoanCalculator) ([Demo](https://lupblazordemos.z13.web.core.windows.net/LoanCalculatorPage)) – A loan payments calculator developed with Blazor.
* [Blazor Paint](https://github.com/Lupusa87/BlazorPaint) ([Demo](https://lupblazordemos.z13.web.core.windows.net/PaintPage)) – Drawing app written in Blazor.
* [Blazor Password Pattern](https://github.com/Lupusa87/BlazorPasswordPattern) ([Demo](https://lupblazordemos.z13.web.core.windows.net/PasswordPatternPage)) – Password pattern based on SVG.
* [Blazor Performance Chart](https://lupblazordemos.z13.web.core.windows.net/PerformanceChartPage) – Performance Chart based on SVG.
* [Blazor RealWorld example app](https://github.com/torhovland/blazor-realworld-example-app) – A full-stack app built with Blazor that includes CRUD operations, authentication, routing, and pagination.
* [Blazor RSS Reader](https://github.com/lohithgn/blazor-rss-reader) ([Demo](https://blazorrssreader.surge.sh/)) – RSS Reader using Blazor.
* [Blazor Spreadsheet](https://github.com/Lupusa87/BlazorSpreadsheet) ([Demo](https://lupblazordemos.z13.web.core.windows.net/SpreadsheetPage)) – Spreadsheet app developed in Blazor.
* [Blazor Sushi](https://github.com/lohithgn/blazor-sushi) ([Demo](https://blazorsushi.surge.sh/)) – Kendo UI Sushi SPA recreated in Blazor.
* [Blazor To-Do App](https://github.com/BorowskiKamil/blazor-tasks) – A Blazor app that allows you to create and edit tasks and manage categories of tasks.
* [Blazor Tour of Heroes](https://github.com/lohithgn/blazor-tour-of-heroes) – A Blazor implementation of [Angular Tour of Heroes](https://angular.io/tutorial).
* [Blazor UWP Sample](https://github.com/pushqrdx/Blazor.Universal) – Use Blazor.Server to build UWP apps.
* [BlazorServiceWorker](https://github.com/roboriaan/BlazorServiceWorker) – A client-side Blazor template with service worker caching.
* [Blazume](https://github.com/Amine-Smahi/Blazume) – A portfolio/resume template using Blazor.
* [Bolero.TodoMVC](https://github.com/fsbolero/TodoMVC) – A TodoMVC clone using Bolero.
* [CssBuilder](https://www.nuget.org/packages/BlazorComponentUtilities/) – A clean code approach to conditional CSS classes for Razor components in Blazor.
* [Data Driven Layout](https://github.com/hutchcodes/Blazor.DataDrivenLayout) ([Blog post](https://hutchcodes.net/2018/09/data-driven-layout-in-razor-components/)) – Two ways of driving the layout based on data in the page.
* [Do](https://github.com/jamie-lord/do) ([Demo](https://do.lord.technology)) – Todo.txt compatible todo app.
* [FMRL](https://github.com/ebekker/FMRL) – Ephemeral Message Service. Messages sent are encrypted, securely transferred, and automatically deleted when they are retrieved.
* [Money](https://github.com/maraf/Money) ([Demo](https://money.neptuo.com)) – A money manager implemented using CQRS+ES.
* [Planning Poker for Azure](https://github.com/duracellko/planningpoker4azure) ([Demo](http://planningpoker.duracellko.net)) – An app to play [Planning Poker™](https://www.planningpoker.com) for distributed teams. The app is implemented using Blazor and shows how to switch between client-side and server-side mode with a configuration change. *Planning Poker* is a registered trademark of [Mountain Goat Software, LLC](https://www.mountaingoatsoftware.com/).
* [Toss](https://github.com/RemiBou/Toss.Blazor) – A Twitter-like web app that allows the user to sign in, post a new message (a "toss") with hashtag, and select favorite hashtags for finding messages.
* [TreeCRUD](https://github.com/ctrl-alt-d/TreeCrud) – A simple server-side Blazor CRUD app to deal with hierarchical data. The project has a data layer with GraphQL for R (Read) and classical REST for CUD (Create, Update, Delete).
* [TrendTv](https://github.com/MattMarked/TrendTv) ([Demo](http://zaptube2.azurewebsites.net/)) – Fetch a video list from YouTube and "zap" in real time between trending videos, filtered by country or category.
* [Try F# on WebAssembly](https://github.com/fsbolero/TryFSharpOnWasm) – The F# compiler running in WebAssembly with Bolero.
* [Tzaar](https://github.com/paularundel/tzaar) ([Demo](https://tzaar.azurewebsites.net/)) – Implementation of the board game Tzaar with Blazor and SignalR.
* [Quiz](https://github.com/Amine-Smahi/BlazorQuiz) – Simple quiz using Blazor.
* [Validation Controls using Blazor](https://github.com/hishamco/BlazorValidationControls) – Blog posts: [Part I: Basic Validation Controls](http://www.hishambinateya.com/part1-validation-controls-using-blazor-basic-validation-controls) | [Part II: Custom Validation Controls](http://www.hishambinateya.com/part2-validation-controls-using-blazor-custom-validation-controls)
* [WebSocketPage](https://github.com/Lupusa87/BlazorWebSocketHelper) ([Demo](https://lupblazordemos.z13.web.core.windows.net/WebSocketPage)) – WebSocket example for Blazor.
## Tooling
* [BlazorFiddle](https://blazorfiddle.com) – Blazor .NET developer playground and code editor in the browser.
* [Blazor Minimum Project Templates](https://github.com/jsakamoto/BlazorMinimumTemplates) – A project templates package of Blazor apps without JavaScript and CSS libraries.
* [Blazor Snippets Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=ScottSauber.blazorsnippets) – A Visual Studio Code extension that offers Blazor and Razor snippets.
* [Razor+ Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=austincummings.razor-plus) – A Visual Studio Code extension that offers improved Razor support.
## Community documentation
* [Awesome Blazor](https://github.com/AdrienTorris/awesome-blazor) – A collection of useful Blazor resources.
* [Blazor Bites](https://chrissainty.com/tag/blazor-bites/) – Posts on ASP.NET Core and Blazor subjects.
* [Learn Blazor](https://learn-blazor.com/) – Community documentation on Blazor.
* [LightSwitch Help Website](https://lightswitchhelpwebsite.com/Blog/tabid/61/tagid/66/Blazor.aspx) – Blogs and code samples primarily covering server-side Blazor (Razor Components).
* [WebAssemblyMan](https://www.webassemblyman.com/) – Man page for Blazor and WebAssembly.
## Books
* [Blazor Revealed](https://www.apress.com/gp/book/9781484243428) – Build web apps in Microsoft .NET that run in any modern browser, helping you to transfer your .NET experience and skills to a new environment and build browser-based apps using a robust and type-safe language and runtime.
* [Blazor Quick Start Guide: Build web applications using Blazor, EF Core, and SQL Server (2018)](https://amzn.to/2OToEji) – An introduction to Blazor core concepts and how to apply concepts to real-world web apps with the help of Entity Framework Core and SQL Server.
* [Dockerizing ASP.NET Core and Blazor Applications on Mac](https://www.c-sharpcorner.com/ebooks/dockerizing-asp-net-core-and-blazor-applications-on-mac) – This book is targeted for beginning to intermediate .NET developers who want to jump into ASP.NET Core, Blazor, and Docker on macOS.
## Courses
* [Blazor First Look on LinkedIn Learning](https://www.linkedin.com/learning/blazor-first-look)
* [Free Blazor Training Course](https://www.devexpress.com/support/training/blazor/)
## Streams and podcasts
* [Blazor StateHasChanged: The weekly community live show](https://www.youtube.com/edwardcharbeneau)
## Other
* [Bionic](https://bionicframework.github.io/Documentation) – An Ionic CLI clone for Blazor projects.
* [Bolero](https://github.com/fsbolero/Bolero) – Blazor for F# with hot reloaded templates, type-safe endpoints and routing, remoting, and much more.
================================================
FILE: docfx.json
================================================
{
"metadata": [
{
"src": [
{
"files": [
"src/**.dll"
]
}
],
"dest": "api",
"disableGitFeatures": false
}
],
"build": {
"content": [
{
"files": [
"api/**.yml",
"toc.yml",
"**/*.md"
],
"exclude": [
"**/obj/**",
"**/sample/**",
"**/samples/**",
"**/includes/**",
"_site/**"
],
"src": "."
}
],
"resource": [
{
"files": [
"**/*.png",
"**/*.jpg"
],
"exclude": [
"**/obj/**",
"**/includes/**",
"_site/**"
],
"src": "."
}
],
"overwrite": [],
"dest": "_site",
"globalMetadataFiles": [],
"fileMetadataFiles": [],
"template": [
"default",
"template"
],
"postProcessors": [],
"noLangKeyword": false,
"keepFileLink": false,
"cleanupCacheHistory": false,
"disableGitFeatures": false,
"globalMetadata": {
"_gitContribute": {
"branch": "master"
}
}
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/App.cshtml
================================================
<!--
Configuring this here is temporary. Later we'll move the app config
into Program.cs, and it won't be necessary to specify AppAssembly.
-->
<Router AppAssembly=typeof(Program).Assembly />
================================================
FILE: docs/common/samples/3.x/BlazorSample/BlazorSample.csproj
================================================
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netstandard2.0</TargetFramework>
<RunCommand>dotnet</RunCommand>
<RunArguments>blazor serve</RunArguments>
<LangVersion>7.3</LangVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.AspNetCore.Blazor.Browser" Version="0.7.0" />
<PackageReference Include="Microsoft.AspNetCore.Blazor.Build" Version="0.7.0" />
<DotNetCliToolReference Include="Microsoft.AspNetCore.Blazor.Cli" Version="0.7.0" />
</ItemGroup>
</Project>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Components/ListViewTemplate.cshtml
================================================
@typeparam TItem
<ul>
@foreach (var item in Items)
{
@ItemTemplate(item)
}
</ul>
@functions {
[Parameter] RenderFragment<TItem> ItemTemplate { get; set; }
[Parameter] IReadOnlyList<TItem> Items { get; set; }
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Components/Tab.cshtml
================================================
@using BlazorSample.UIInterfaces
@implements IDisposable
@implements ITab
<li>
<a onclick=@Activate class="nav-link @TitleCssClass" role="button">
@Title
</a>
</li>
@functions {
[CascadingParameter] TabSet ContainerTabSet { get; set; }
[Parameter] string Title { get; set; }
[Parameter] public RenderFragment ChildContent { get; private set; }
string TitleCssClass => ContainerTabSet.ActiveTab == this ? "active" : null;
protected override void OnInit()
{
ContainerTabSet.AddTab(this);
}
public void Dispose()
{
ContainerTabSet.RemoveTab(this);
}
void Activate()
{
ContainerTabSet.SetActivateTab(this);
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Components/TabSet.cshtml
================================================
@using BlazorSample.UIInterfaces
<!-- Display the tab headers -->
<CascadingValue Value=this>
<ul class="nav nav-tabs">
@ChildContent
</ul>
</CascadingValue>
<!-- Display body for only the active tab -->
<div class="nav-tabs-body p-4">
@ActiveTab?.ChildContent
</div>
@functions {
[Parameter] RenderFragment ChildContent { get; set; }
public ITab ActiveTab { get; private set; }
public void AddTab(ITab tab)
{
if (ActiveTab == null)
{
SetActivateTab(tab);
}
}
public void RemoveTab(ITab tab)
{
if (ActiveTab == tab)
{
SetActivateTab(null);
}
}
public void SetActivateTab(ITab tab)
{
if (ActiveTab != tab)
{
ActiveTab = tab;
StateHasChanged();
}
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Components/TableTemplate.cshtml
================================================
@typeparam TItem
<table class="table">
<thead>
<tr>@TableHeader</tr>
</thead>
<tbody>
@foreach (var item in Items)
{
<tr>@RowTemplate(item)</tr>
}
</tbody>
<tfoot>
<tr>@TableFooter</tr>
</tfoot>
</table>
@functions {
[Parameter] RenderFragment TableHeader { get; set; }
[Parameter] RenderFragment<TItem> RowTemplate { get; set; }
[Parameter] RenderFragment TableFooter { get; set; }
[Parameter] IReadOnlyList<TItem> Items { get; set; }
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/JsInteropClasses/ExampleJsInterop.cs
================================================
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Threading.Tasks;
using Microsoft.JSInterop;
namespace BlazorSample.JsInteropClasses
{
#region snippet1
public class ExampleJsInterop
{
public static Task<string> Prompt(string text)
{
// showPrompt is implemented in wwwroot/exampleJsInterop.js
return JSRuntime.Current.InvokeAsync<string>(
"exampleJsFunctions.showPrompt",
text);
}
public static Task<string> Display(string welcomeMessage)
{
// displayWelcome is implemented in wwwroot/exampleJsInterop.js
return JSRuntime.Current.InvokeAsync<string>(
"exampleJsFunctions.displayWelcome",
welcomeMessage);
}
public static Task CallHelloHelperSayHello(string name)
{
// sayHello is implemented in wwwroot/exampleJsInterop.js
return JSRuntime.Current.InvokeAsync<object>(
"exampleJsFunctions.sayHello",
new DotNetObjectRef(new HelloHelper(name)));
}
}
#endregion
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/JsInteropClasses/HelloHelper.cs
================================================
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.JSInterop;
namespace BlazorSample.JsInteropClasses
{
#region snippet1
public class HelloHelper
{
public HelloHelper(string name)
{
Name = name;
}
public string Name { get; set; }
[JSInvokable]
public string SayHello() => $"Hello, {Name}!";
}
#endregion
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/BlazorRocks.cshtml
================================================
@page "/BlazorRocks"
@*
The inherit directive provides the properties and methods
of the BlazorRocksBase class to this component.
*@
@inherits BlazorRocksBase
<h1>@BlazorRocksText</h1>
<h2>BlazorRocks.cshtml</h2>
<p>
The heading content is supplied by a property in
the <code>BlazorRocksBase</code> class in another
file, <em>BlazorRocksBase.cs</em>.
<code>BlazorRocksBase</code> is inherited using
the <code>@@inherits BlazorRocksBase</code>
directive.
</p>
<pre><code>@@inherits BlazorRocksBase
<h1>@@BlazorRocksText</h1></code></pre>
<h2>BlazorRocksBase.cs</h2>
<pre><code>using Microsoft.AspNetCore.Blazor.Components;
public class BlazorRocksBase : BlazorComponent
{
public string BlazorRocksText { get; set; } =
"Blazor rocks the browser!";
}</code></pre>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/BlazorRocksBase.cs
================================================
using Microsoft.AspNetCore.Blazor.Components;
public class BlazorRocksBase : BlazorComponent
{
public string BlazorRocksText { get; set; } = "Blazor rocks the browser!";
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/BlazorRoute.cshtml
================================================
@page "/BlazorRoute"
@page "/DifferentBlazorRoute"
<h1>Blazor routing</h1>
<p>
Reach this page component on two routes,
<code>/BlazorRoute</code> and
<code>/DifferentBlazorRoute</code>.
</p>
<p>
The routes are supplied to the component
using <code>@@page</code> directives:
</p>
<pre><code>@@page "/BlazorRoute"
@@page "/DifferentBlazorRoute"
<h1>Blazor routing</h1></code></pre>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/CascadingValuesParametersTabSet.cshtml
================================================
@page "/CascadingValuesParametersTabSet"
<h1>Cascading Values & Parameters - TabSet</h1>
<!-- <snippet_TabSet> -->
<TabSet>
<Tab Title="First tab">
<h4>Greetings from the first tab!</h4>
<label>
<input type="checkbox" bind=@showThirdTab />
Toggle third tab
</label>
</Tab>
<Tab Title="Second tab">
<h4>The second tab says Hello World!</h4>
</Tab>
@if (showThirdTab)
{
<Tab Title="Third tab">
<h4>Welcome to the disappearing third tab!</h4>
<p>Toggle this tab from the first tab.</p>
</Tab>
}
</TabSet>
<!-- </snippet_TabSet> -->
<h2>ITab.cs</h2>
<p>The <code>ITab</code> interface is implemented by tabs:</p>
<pre><code>@@using Microsoft.AspNetCore.Blazor;
namespace BlazorSample.UIInterfaces
{
public interface ITab
{
RenderFragment ChildContent { get; }
}
}</code></pre>
<h2>Component</h2>
<p>This component (<em>CascadingValuesParametersTabSet.cshtml</em>) uses the <code>TabSet</code> component, which contains several <code>Tab</code> components:</p>
<pre><code><TabSet>
<Tab Title="First tab">
<h4>Greetings from the first tab!</h4>
<label>
<input type="checkbox" bind=@@showThirdTab />
Toggle third tab
</label>
</Tab>
<Tab Title="Second tab">
<h4>The second tab says Hello World!</h4>
</Tab>
@@if (showThirdTab)
{
<Tab Title="Third tab">
<h4>Welcome to the disappearing third tab!</h4>
<p>Toggle this tab from the first tab.</p>
</Tab>
}
</TabSet>
@@functions
{
bool showThirdTab;
}</code></pre>
<h2>TabSet.csthml</h2>
<p>The child <code>Tab</code> components aren't explicitly passed as parameters to the <code>TabSet</code>. Instead, the child <code>Tab</code> components are part of the child content of the <code>TabSet</code>. However, the <code>TabSet</code> still needs to know about each <code>Tab</code> so that it can render the headers and the active tab. To enable this coordination without requiring additional code, the <code>TabSet</code> component <em>can provide itself as a cascading value</em> that is then picked up by the descendent <code>Tab</code> components.</p>
<pre><code>@@using BlazorSample.UIInterfaces
<!-- Display the tab headers -->
<CascadingValue Value=this>
<ul class="nav nav-tabs">
@@ChildContent
</ul>
</CascadingValue>
<!-- Display body for only the active tab -->
<div class="nav-tabs-body p-4">
@@ActiveTab?.ChildContent
</div>
@@functions {
[Parameter] RenderFragment ChildContent { get; set; }
public ITab ActiveTab { get; private set; }
public void AddTab(ITab tab)
{
if (ActiveTab == null)
{
SetActivateTab(tab);
}
}
public void RemoveTab(ITab tab)
{
if (ActiveTab == tab)
{
SetActivateTab(null);
}
}
public void SetActivateTab(ITab tab)
{
if (ActiveTab != tab)
{
ActiveTab = tab;
StateHasChanged();
}
}
}</code></pre>
<h2>Tab.cshtml</h2>
<p>The descendent <code>Tab</code> components capture the containing <code>TabSet</code> as a cascading parameter, so the <code>Tab</code> components add themselves to the <code>TabSet</code> and coordinate on which <code>Tab</code> is active.</p>
<pre><code>@@using BlazorSample.UIInterfaces
@@implements IDisposable
@@implements ITab
<li>
<a onclick=@@Activate class="nav-link @@TitleCssClass" role="button">
@@Title
</a>
</li>
@@functions {
[CascadingParameter] TabSet ContainerTabSet { get; set; }
[Parameter] string Title { get; set; }
[Parameter] public RenderFragment ChildContent { get; private set; }
string TitleCssClass => ContainerTabSet.ActiveTab == this ? "active" : null;
protected override void OnInit()
{
ContainerTabSet.AddTab(this);
}
public void Dispose()
{
ContainerTabSet.RemoveTab(this);
}
void Activate()
{
ContainerTabSet.SetActivateTab(this);
}
}</code></pre>
@functions
{
bool showThirdTab;
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/CascadingValuesParametersTheme.cshtml
================================================
@page "/cascadingvaluesparameterstheme"
@layout CascadingValuesParametersLayout
@using BlazorSample.UIThemeClasses
<h1>Cascading Values & Parameters - Theme</h1>
<p>Current count: @currentCount</p>
<p><button class="btn" onclick="@IncrementCount">Increment Counter (Unthemed)</button></p>
<p><button class="btn @ThemeInfo.ButtonClass" onclick="@IncrementCount">Increment Counter (Themed)</button></p>
@functions {
int currentCount = 0;
[CascadingParameter] protected ThemeInfo ThemeInfo { get; set; }
void IncrementCount()
{
currentCount++;
}
}
<p>The layout component (<em>CascadingValuesParametersLayout.cshtml</em>) supplies a cascading <code>ThemeInfo</code> object to the components of the <code>Body</code> property that use this layout:</p>
<pre><code>@@inherits BlazorLayoutComponent
@@using BlazorSample.UIThemeClasses
<div class="container-fluid">
<div class="row">
<div class="col-sm-3">
<NavMenu />
</div>
<div class="col-sm-9">
<CascadingValue Value="@@theme">
<div class="content px-4">
@@Body
</div>
</CascadingValue>
</div>
</div>
</div>
@@functions {
ThemeInfo theme = new ThemeInfo { ButtonClass = "btn-success" };
}</code></pre>
<p>This component (<em>CascadingValuesParametersTheme.cshtml</em>) receives the <code>ThemeInfo</code> as a <code>CascadingParameter</code>. The parameter is used to style one of the buttons:</p>
<pre><code><button class="btn" onclick="@@IncrementCount">Increment Counter (Unthemed)</button>
<button class="btn @@ThemeInfo.ButtonClass" onclick="@@IncrementCount">Increment Counter (Themed)</button>
@@functions {
int currentCount = 0;
[CascadingParameter] protected ThemeInfo ThemeInfo { get; set; }
void IncrementCount()
{
currentCount++;
}
}</code></pre>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/ChildComponent.cshtml
================================================
<div class="panel panel-success">
<div class="panel-heading">@Title</div>
<div class="panel-body">@ChildContent</div>
</div>
@functions {
[Parameter]
private string Title { get; set; }
[Parameter]
private RenderFragment ChildContent { get; set; }
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/FetchData.cshtml
================================================
@page "/fetchdata"
@page "/fetchdata/{StartDate:datetime}"
@inject HttpClient Http
<h1>Weather forecast</h1>
<p>This component demonstrates fetching data from the server.</p>
@if (forecasts == null)
{
<p><em>Loading...</em></p>
}
else
{
<table class='table'>
<thead>
<tr>
<th>Date</th>
<th>Temp. (C)</th>
<th>Temp. (F)</th>
<th>Summary</th>
</tr>
</thead>
<tbody>
@foreach (var forecast in forecasts)
{
<tr>
<td>@forecast.DateFormatted</td>
<td>@forecast.TemperatureC</td>
<td>@forecast.TemperatureF</td>
<td>@forecast.Summary</td>
</tr>
}
</tbody>
</table>
<p>
<a href="fetchdata/@StartDate.AddDays(-5).ToString("yyyy-MM-dd")" class="btn btn-secondary float-left">
◀ Previous
</a>
<a href="fetchdata/@StartDate.AddDays(5).ToString("yyyy-MM-dd")" class="btn btn-secondary float-right">
Next ▶
</a>
</p>
}
@functions {
[Parameter] DateTime StartDate { get; set; }
WeatherForecast[] forecasts;
public override void SetParameters(ParameterCollection parameters)
{
StartDate = DateTime.Now;
base.SetParameters(parameters);
}
protected override async Task OnParametersSetAsync()
{
forecasts = await Http.GetJsonAsync<WeatherForecast[]>(
$"sample-data/weather.json?date={StartDate.ToString("yyyy-MM-dd")}");
// Because StandaloneApp doesn't really have a server endpoint to get dynamic data from,
// fake the DateFormatted values here. This would not apply in a real app.
for (var i = 0; i < forecasts.Length; i++)
{
forecasts[i].DateFormatted = StartDate.AddDays(i).ToShortDateString();
}
}
class WeatherForecast
{
public string DateFormatted { get; set; }
public int TemperatureC { get; set; }
public int TemperatureF { get; set; }
public string Summary { get; set; }
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/HeadingComponent.cshtml
================================================
@using System.Globalization
@*
The 'using' directive makes System.Globalization available to
the component. System.Globalization provides a method for
converting a string into title case (capitalizes the first
letter of every word in a string), which is used to convert a
a string into title case for a heading.
*@
@*
Heading text is rendered by evaluating the _headingText field.
The font-style of the heading is rendered by evaluating the
_headingFontStyle field.
*@
<h1 style="font-style:@_headingFontStyle">@_headingText</h1>
<form>
<div class="form-check">
@*
A check box sets the font style and is bound to the
_italicsCheck field.
*@
<input type="checkbox" class="form-check-input"
id="italicsCheck" bind="@_italicsCheck" />
<label class="form-check-label"
for="italicsCheck">Use italics</label>
</div>
@*
When the form is submitted, the onclick event executes
the UpdateHeading method.
*@
<button type="button" class="btn btn-primary" onclick="@UpdateHeading">
Update heading
</button>
</form>
@functions {
private static TextInfo _tinfo = CultureInfo.CurrentCulture.TextInfo;
private string _headingText =
_tinfo.ToTitleCase("welcome to blazor!");
private string _headingFontStyle = "normal";
private bool _italicsCheck = false;
// When UpdateHeading is executed, _italicsCheck determines
// the value of _headingFontStyle to set the font style of the
// heading.
public void UpdateHeading()
{
_headingFontStyle = _italicsCheck ? "italic" : "normal";
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/Index.cshtml
================================================
@page "/"
@*
The page directive indicates this component is available as a page
at the root of the app, the "/" route.
*@
@*
Razor components can be nested. HeadingComponent is a component
supplied by the Razor file HeadingComponent.cshtml.
*@
<HeadingComponent />
<h2>Index.cshtml</h2>
<p>
<code>HeadingComponent</code> (<em>HeadingComponent.cshtml</em>)
is embedded within this Index page component:
</p>
<pre><code><HeadingComponent /></code></pre>
<h2>HeadingComponent.cshtml</h2>
<pre><code>@@System.Globalization
@@*
The 'using' directive makes System.Globalization available to
the component.
*@@
@@*
Heading text is rendered by evaluating the _headingText field.
The font-style of the heading is rendered by evaluating the
_headingFontStyle field.
*@@
<h1 style="font-style:@@_headingFontStyle">@@_headingText</h1>
<form>
<div class="form-check">
@@*
A check box sets the font style and is bound to the _italicsCheck field.
*@@
<input type="checkbox" class="form-check-input" id="italicsCheck" bind="@@_italicsCheck" />
<label class="form-check-label" for="italicsCheck">Use italics</label>
</div>
@@*
When the form is submitted, the onclick event executes
the UpdateHeading method.
*@@
<button type="button" class="btn btn-primary" onclick="@@UpdateHeading">
Update heading
</button>
</form>
@@functions {
private static TextInfo _tinfo = CultureInfo.CurrentCulture.TextInfo;
private string _headingText = _tinfo.ToTitleCase("welcome to blazor!");
private string _headingFontStyle = "normal";
private bool _italicsCheck = false;
// When UpdateHeading is executed, _italicsCheck determines
// the value of _headingFontStyle to set the font style of the
// heading.
public void UpdateHeading()
{
_headingFontStyle = _italicsCheck ? "italic" : "normal";
}
}</code></pre>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/JSInterop.cshtml
================================================
@page "/JSInterop"
@using BlazorSample.JsInteropClasses
@using Microsoft.JSInterop;
<h1>JavaScript Interop</h1>
<h2>Invoke JavaScript functions from .NET methods</h2>
<button type="button" class="btn btn-primary" onclick="@TriggerJsPrompt">
Trigger JavaScript Prompt
</button>
<h3 id="welcome" style="color:green;font-style:italic"></h3>
@functions {
public async void TriggerJsPrompt()
{
var name = await ExampleJsInterop.Prompt("What's your name?");
await ExampleJsInterop.Display($"Hello {name}! Welcome to Blazor!");
}
}
<p>
When <code>TriggerJsPrompt</code> is executed by selecting the component's <b>Trigger JavaScript Prompt</b> button, the <code>ExampleJsInterop.Prompt</code> method in C# code is called.
</p>
<p>
The <code>Prompt</code> method executes the JavaScript <code>showPrompt</code> function provided in the <em>wwwroot/exampleJsInterop.js</em> file.
</p>
<p>
The <code>showPrompt</code> function accepts user input (the user's name), which is HTML-encoded and returned to the <code>Prompt</code> method and ultimately back to the component. The component stores the user's name in a local variable, <code>name</code>.
</p>
<p>
The string stored in <code>name</code> is incorporated into a welcome message, which is passed to a second C# method, <code>ExampleJsInterop.Display</code>.
</p>
<p>
<code>Display</code> calls a JavaScript function, <code>displayWelcome</code>, which renders the welcome message into a heading tag.
</p>
<h2>Invoke .NET methods from JavaScript functions</h2>
<p>Examine the console output in your broswer's developer tools when selecting the following buttons to trigger .NET static and instance methods.</p>
<p>When the button to call the C# static method is selected, the JavaScript <code>returnArrayAsyncJs</code> function in <em>wwwroot/exampleJsInterop.js</em> is executed. The function uses <code>DotNet.invokeMethodAsync</code> to call the C# static method <code>ReturnArrayAsync</code>. The C# method returns an integer array to the JavaScript function, which writes the array to the console.</p>
<p>When the button to call the C# instance method is selected, <code>ExampleJsInterop.CallHelloHelperSayHello</code> is called and passes a name to the method. <code>ExampleJsInterop.CallHelloHelperSayHello</code> invokes the JavaScript function <code>sayHello</code> with a new instance of <code>HelloHelper</code>. The name is passed to <code>HelloHelper</code>'s constructor, which sets the <code>HelloHelper.Name</code> property. When the JavaScript function <code>sayHello</code> is executed, <code>HelloHelper.SayHello</code> returns the <code>Hello, {Name}!</code> message, which is written to the console.</p>
<button type="button" class="btn btn-primary"
onclick="exampleJsFunctions.returnArrayAsyncJs()">
Trigger .NET static method ReturnArrayAsync
</button>
@functions {
[JSInvokable]
public static Task<int[]> ReturnArrayAsync()
{
return Task.FromResult(new int[] { 1, 2, 3 });
}
}
<button type="button" class="btn btn-primary" onclick="@TriggerNetInstanceMethod">
Trigger .NET instance method HelloHelper.SayHello
</button>
@functions {
public async void TriggerNetInstanceMethod()
{
await ExampleJsInterop.CallHelloHelperSayHello("Blazor");
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/ParentComponent.cshtml
================================================
@page "/ParentComponent"
<h1>Parent-child example</h1>
<ChildComponent Title="Panel Title from Parent">
Child content of the child component is supplied by the parent component.
</ChildComponent>
<p>
<code>ParentComponent</code> (<em>ParentComponent.cshtml</em>; this page)
embeds a child component into the page using the <code><ChildComponent></code>
tag. The child component (<em>ChildComponent.cshtml</em>) contains a
Bootstrap-styled panel.
</p>
<p>
The <code>Title</code> attribute and panel content are specified by the
<code><ChildComponent></code> element. The <code>Title</code> attribute
is a <i>component parameter</i>.
</p>
<h2>ParentComponent.cshtml</h2>
<pre><code><ChildComponent Title="Panel Title from Parent">
Child content of the child component is supplied by the parent component.
</ChildComponent></code></pre>
<h2>ChildComponent.cshtml</h2>
<pre><code><div class="panel panel-success">
<div class="panel-heading">@@Title</div>
<div class="panel-body">@@ChildContent</div>
</div>
@@functions {
[Parameter]
private string Title { get; set; }
[Parameter]
private RenderFragment ChildContent { get; set; }
}</code></pre>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/RazorTemplates.cshtml
================================================
@page "/RazorTemplates"
<h1>Razor Templates</h1>
<p>Render fragments can be defined using Razor template syntax. Razor templates are a way to define a UI snippet.</p>
<pre><code>@@{
RenderFragment template = @@<p>The time is @DateTime.Now.</p>;
RenderFragment<Pet> petTemplate = (pet) => @@<p>Your pet's name is @@pet.Name.</p>;
}
</code></pre>
@{
RenderFragment template = @<p>The time is @DateTime.Now.</p>;
RenderFragment<Pet> petTemplate = (pet) => @<p>Your pet's name is @pet.Name.</p>;
}
<p>Render fragments defined using Razor templates can be passed as arguments to templated components or rendered directly. For example, the previous templates are directly rendered with the following Razor markup:</p>
<pre><code>@@template
@@petTemplate(new Pet { Name = "Rex" })</code></pre>
@template
@petTemplate(new Pet { Name = "Rex" })
@functions {
List<Pet> pets = new List<Pet>
{
new Pet { PetId = 1, Name = "Rin Tin Tin" },
new Pet { PetId = 2, Name = "Mr. Bigglesworth" },
new Pet { PetId = 3, Name = "Fred" },
new Pet { PetId = 4, Name = "Salem Saberhagen" },
new Pet { PetId = 5, Name = "Lassie" },
new Pet { PetId = 6, Name = "Spot" },
new Pet { PetId = 7, Name = "K-9" }
};
class Pet
{
public int PetId { get; set; }
public string Name { get; set; }
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/RouteParameter.cshtml
================================================
@page "/RouteParameter"
@page "/RouteParameter/{text}"
<h1>Blazor is @Text!</h1>
@functions {
[Parameter]
private string Text { get; set; } = "fantastic";
}
<h2>RouteParameter.cshtml</h2>
<p>
Request this page with a route parameter, and the
parameter is included in the heading. The Blazor
client-side router uses route parameters to populate
the corresponding component parameters.
</p>
<pre><code>@@page "/RouteParameter"
@@page "/RouteParameter/{Text}"
<h1>Blazor is @@Text!</h1>
@@functions {
[Parameter]
private string Text { get; set; } = "fantastic";
}</code></pre>
<p>
Example:
<pre><code>/RouteParameter/amazing</code></pre>
Renders HTML:
<pre><code><h1>Blazor is amazing!</h1></code></pre>
</p>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/TemplatedComponents.cshtml
================================================
@page "/TemplatedComponents"
<h1>Templated Components</h1>
<p>Templated components are components that accept one or more UI templates as parameters, which can then be used as part of the component's rendering logic. Templated components allow you to author higher-level components that are more reusable than regular components.</p>
<p>The following table template examples use the template defined in <em>Components/TableTemplate.cshtml</em>.</p>
<h2>Implicit template parameters</h2>
<p>Component arguments of type <code>RenderFragment<T></code> passed as elements have an implicit parameter named <code>context</code>.</p>
<pre><code><TableTemplate Items="@@pets">
<TableHeader>
<th>ID</th>
<th>Name</th>
</TableHeader>
<RowTemplate>
<td>@@context.PetId</td>
<td>@@context.Name</td>
</RowTemplate>
</TableTemplate></code></pre>
<TableTemplate Items="@pets">
<TableHeader>
<th>ID</th>
<th>Name</th>
</TableHeader>
<RowTemplate>
<td>@context.PetId</td>
<td>@context.Name</td>
</RowTemplate>
</TableTemplate>
<h2>Explicit template parameters</h2>
<p>You can change the template parameter name using the <code>Context</code> attribute on the child element.</p>
<pre><code><TableTemplate Items="@@pets">
<TableHeader>
<th>ID</th>
<th>Name</th>
<th>TV Show/Movie</th>
</TableHeader>
<RowTemplate Context="pet">
<td>@@pet.PetId</td>
<td>@@pet.Name</td>
</RowTemplate>
</TableTemplate></code></pre>
<TableTemplate Items="@pets">
<TableHeader>
<th>ID</th>
<th>Name</th>
</TableHeader>
<RowTemplate Context="pet">
<td>@pet.PetId</td>
<td>@pet.Name</td>
</RowTemplate>
</TableTemplate>
<h2>Generic-typed Components</h2>
<p>Templated components are often generically typed. For example, a generic ListView component can be used to render <code>IEnumerable<T></code> values. To define a generic component, use the <code>@@typeparam</code> directive to specify type parameters.</p>
<p>The following ListView template examples use the template defined in <em>Components/ListViewTemplate.cshtml</em>.</p>
<p>Inferred type:</p>
<pre><code><ListViewTemplate Items="@@pets">
<ItemTemplate Context="pet">
<li>@@pet.Name</li>
</ItemTemplate>
</ListViewTemplate></code></pre>
<ListViewTemplate Items="@pets">
<ItemTemplate Context="pet">
<li>@pet.Name</li>
</ItemTemplate>
</ListViewTemplate>
<p>Explicitly typed (<code>TItem="Pet"</code>):</p>
<pre><code><ListViewTemplate Items="@@pets" TItem="Pet">
<ItemTemplate Context="pet">
<li>@@pet.Name</li>
</ItemTemplate>
</ListViewTemplate></code></pre>
<ListViewTemplate Items="@pets" TItem="Pet">
<ItemTemplate Context="pet">
<li>@pet.Name</li>
</ItemTemplate>
</ListViewTemplate>
@functions {
List<Pet> pets = new List<Pet>
{
new Pet { PetId = 1, Name = "Rin Tin Tin" },
new Pet { PetId = 2, Name = "Mr. Bigglesworth" },
new Pet { PetId = 3, Name = "Fred" },
new Pet { PetId = 4, Name = "Salem Saberhagen" },
new Pet { PetId = 5, Name = "Lassie" },
new Pet { PetId = 6, Name = "Spot" },
new Pet { PetId = 7, Name = "K-9" }
};
class Pet
{
public int PetId { get; set; }
public string Name { get; set; }
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Pages/_ViewImports.cshtml
================================================
@layout MainLayout
================================================
FILE: docs/common/samples/3.x/BlazorSample/Program.cs
================================================
using Microsoft.AspNetCore.Blazor.Hosting;
namespace BlazorSample
{
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IWebAssemblyHostBuilder CreateHostBuilder(string[] args) =>
BlazorWebAssemblyHost.CreateDefaultBuilder()
.UseBlazorStartup<Startup>();
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/README.md
================================================
# Blazor Sample
This sample illustrates the use of Blazor scenarios described in the Blazor documentation.
================================================
FILE: docs/common/samples/3.x/BlazorSample/Shared/CascadingValuesParametersLayout.cshtml
================================================
@inherits BlazorLayoutComponent
@using BlazorSample.UIThemeClasses
<div class="container-fluid">
<div class="row">
<div class="col-sm-3">
<NavMenu />
</div>
<div class="col-sm-9">
<CascadingValue Value="@theme">
<div class="content px-4">
@Body
</div>
</CascadingValue>
</div>
</div>
</div>
@functions {
ThemeInfo theme = new ThemeInfo { ButtonClass = "btn-success" };
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/Shared/MainLayout.cshtml
================================================
@inherits BlazorLayoutComponent
<div class="container-fluid">
<div class="row">
<div class="col-sm-3">
<NavMenu />
</div>
<div class="col-sm-9">
@Body
</div>
</div>
</div>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Shared/NavMenu.cshtml
================================================
<div class="main-nav">
<div class="navbar navbar-inverse">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="">Blazor Sample</a>
</div>
<div class="clearfix"></div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li>
<NavLink href="" Match=NavLinkMatch.All>
<span class="glyphicon glyphicon-home"></span> Home
</NavLink>
</li>
<li>
<NavLink href="BlazorRoute">
<span class="glyphicon glyphicon-th-list"></span> Blazor Route
</NavLink>
</li>
<li>
<NavLink href="DifferentBlazorRoute">
<span class="glyphicon glyphicon-th-list"></span> Different Blazor Route
</NavLink>
</li>
<li>
<NavLink href="ParentComponent">
<span class="glyphicon glyphicon-th-list"></span> Parent-child Example
</NavLink>
</li>
<li>
<NavLink href="RouteParameter">
<span class="glyphicon glyphicon-th-list"></span> Route Parameter
</NavLink>
</li>
<li>
<NavLink href="BlazorRocks">
<span class="glyphicon glyphicon-th-list"></span> Blazor Rocks!
</NavLink>
</li>
<li>
<NavLink href="FetchData">
<span class="glyphicon glyphicon-th-list"></span> Fetch data
</NavLink>
</li>
<li>
<NavLink href="TemplatedComponents">
<span class="glyphicon glyphicon-th-list"></span> Templated Components
</NavLink>
</li>
<li>
<NavLink href="CascadingValuesParametersTheme">
<span class="glyphicon glyphicon-th-list"></span> Cascading Values & Parameters – Theme
</NavLink>
</li>
<li>
<NavLink href="CascadingValuesParametersTabSet">
<span class="glyphicon glyphicon-th-list"></span> Cascading Values & Parameters – TabSet
</NavLink>
</li>
<li>
<NavLink href="RazorTemplates">
<span class="glyphicon glyphicon-th-list"></span> Razor Templates
</NavLink>
</li>
<li>
<NavLink href="JSInterop">
<span class="glyphicon glyphicon-th-list"></span> JavaScript Interop
</NavLink>
</li>
</ul>
</div>
</div>
</div>
================================================
FILE: docs/common/samples/3.x/BlazorSample/Startup.cs
================================================
using BlazorSample;
using Microsoft.AspNetCore.Blazor.Builder;
using Microsoft.Extensions.DependencyInjection;
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
}
public void Configure(IBlazorApplicationBuilder app)
{
app.AddComponent<App>("app");
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/UIInterfaces/ITab.cs
================================================
using Microsoft.AspNetCore.Blazor;
namespace BlazorSample.UIInterfaces
{
public interface ITab
{
RenderFragment ChildContent { get; }
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/UIThemeClasses/ThemeInfo.cs
================================================
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
namespace BlazorSample.UIThemeClasses
{
public class ThemeInfo
{
public string ButtonClass { get; set; }
}
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/_ViewImports.cshtml
================================================
@using System.Net.Http
@using Microsoft.AspNetCore.Blazor
@using Microsoft.AspNetCore.Blazor.Components
@using Microsoft.AspNetCore.Blazor.Layouts
@using Microsoft.AspNetCore.Blazor.Routing
@using BlazorSample
@using BlazorSample.Shared
================================================
FILE: docs/common/samples/3.x/BlazorSample/wwwroot/css/site.css
================================================
.main-nav li .glyphicon {
margin-right: 10px;
}
/* Highlighting rules for nav menu items */
.main-nav li a.active,
.main-nav li a.active:hover,
.main-nav li a.active:focus {
background-color: #4189C7;
color: white;
}
/* Keep the nav menu independent of scrolling and on top of other items */
.main-nav {
position: fixed;
top: 0;
left: 0;
right: 0;
z-index: 1;
}
p, .panel {
margin-top: 15px
}
/* Styles for the TabSet/Tabs */
.nav-tabs .nav-link {
border-color: #dee2e6 #dee2e6 #fff;
border-bottom-color: #dee2e6;
background-color: #f9f9f9;
}
.nav-tabs .active {
border-top: 4px solid #e0108b !important;
padding-top: 5px;
border-bottom: 1px solid transparent;
background-color: white;
}
.nav-tabs > li {
margin-bottom: -1px;
}
.nav-tabs-body {
border: 1px solid #dee2e6;
border-top-width: 0;
padding: 15px;
}
@media (max-width: 767px) {
/* On small screens, the nav menu spans the full width of the screen. Leave a space for it. */
body {
padding-top: 50px;
}
}
@media (min-width: 768px) {
/* On small screens, convert the nav menu to a vertical sidebar */
.main-nav {
height: 100%;
width: calc(25% - 20px);
}
.main-nav .navbar {
border-radius: 0px;
border-width: 0px;
height: 100%;
}
.main-nav .navbar-header {
float: none;
}
.main-nav .navbar-collapse {
border-top: 1px solid #444;
padding: 0px;
}
.main-nav .navbar ul {
float: none;
}
.main-nav .navbar li {
float: none;
font-size: 15px;
margin: 6px;
}
.main-nav .navbar li a {
padding: 10px 16px;
border-radius: 4px;
}
.main-nav .navbar a {
/* If a menu item's text is too long, truncate it */
width: 100%;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
}
/*
Temporary workaround due to the <blazor-component> wrapper element. The wrapper element
will be eliminated in a future update, making this workaround unnecessary.
*/
.navbar-nav > li a {
color: #9d9d9d;
line-height: 20px;
position: relative;
display: block;
}
.navbar-nav > li a:hover {
color: #fff;
background-color: transparent;
text-decoration: none;
}
.navbar-nav > li a:focus {
text-decoration: none;
}
.alert-survey {
color: #6a6969;
background-color: #e8e8e8;
border-color: #d3d3d3;
margin-top: 25px;
}
.alert-survey a {
font-weight: bold;
}
================================================
FILE: docs/common/samples/3.x/BlazorSample/wwwroot/exampleJsInterop.js
================================================
window.exampleJsFunctions = {
showPrompt: function (text) {
return prompt(text, 'Type your name here');
},
displayWelcome: function (welcomeMessage) {
document.getElementById('welcome').innerText = welcomeMessage;
},
returnArrayAsyncJs: function () {
DotNet.invokeMethodAsync('BlazorSample', 'ReturnArrayAsync')
.then(data => {
data.push(4);
console.log(data);
})
},
sayHello: function (dotnetHelper) {
return dotnetHelper.invokeMethodAsync('SayHello')
.then(r => console.log(r));
}
};
================================================
FILE: docs/common/samples/3.x/BlazorSample/wwwroot/index.html
================================================
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width">
<title>Blazor Sample</title>
<base href="/" />
<link href="css/bootstrap/bootstrap.min.css" rel="stylesheet">
<link href="css/site.css" rel="stylesheet">
</head>
<body>
<app>Loading...</app>
<script src="css/bootstrap/bootstrap-native.min.js"></script>
<script src="_framework/blazor.webassembly.js"></script>
<script src="exampleJsInterop.js"></script>
</body>
</html>
================================================
FILE: docs/common/samples/3.x/BlazorSample/wwwroot/sample-data/weather.json
================================================
[
{
"dateFormatted": "06/05/2018",
"temperatureC": 1,
"summary": "Freezing",
"temperatureF": 33
},
{
"dateFormatted": "07/05/2018",
"temperatureC": 14,
"summary": "Bracing",
"temperatureF": 57
},
{
"dateFormatted": "08/05/2018",
"temperatureC": -13,
"summary": "Freezing",
"temperatureF": 9
},
{
"dateFormatted": "09/05/2018",
"temperatureC": -16,
"summary": "Balmy",
"temperatureF": 4
},
{
"dateFormatted": "10/05/2018",
"temperatureC": -2,
"summary": "Chilly",
"temperatureF": 29
}
]
================================================
FILE: docs/component-libraries.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/class-libraries">
</head>
<body>
</body>
</html>
================================================
FILE: docs/components/index.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/components">
</head>
<body>
</body>
</html>
================================================
FILE: docs/debugging.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/debug">
</head>
<body>
</body>
</html>
================================================
FILE: docs/dependency-injection.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/dependency-injection">
</head>
<body>
</body>
</html>
================================================
FILE: docs/get-started.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/get-started">
</head>
<body>
</body>
</html>
================================================
FILE: docs/host-and-deploy/configure-linker.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/host-and-deploy/blazor/configure-linker">
</head>
<body>
</body>
</html>
================================================
FILE: docs/host-and-deploy/index.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/host-and-deploy/blazor/">
</head>
<body>
</body>
</html>
================================================
FILE: docs/hosting-models/samples_snapshot/Startup.cs
================================================
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddServerSideBlazor<App.Startup>();
services.AddResponseCompression(options =>
{
options.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(new[]
{
MediaTypeNames.Application.Octet,
WasmMediaTypeNames.Application.Wasm,
});
});
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseResponseCompression();
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
// Use component registrations and static files from the app project.
app.UseServerSideBlazor<App.Startup>();
}
}
================================================
FILE: docs/hosting-models.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/hosting-models">
</head>
<body>
</body>
</html>
================================================
FILE: docs/index.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/">
</head>
<body>
</body>
</html>
================================================
FILE: docs/introduction/faq.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/">
</head>
<body>
</body>
</html>
================================================
FILE: docs/introduction/index.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/">
</head>
<body>
</body>
</html>
================================================
FILE: docs/javascript-interop.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/javascript-interop">
</head>
<body>
</body>
</html>
================================================
FILE: docs/layouts.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/layouts">
</head>
<body>
</body>
</html>
================================================
FILE: docs/routing.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/blazor/routing">
</head>
<body>
</body>
</html>
================================================
FILE: docs/toc.md
================================================
# [Get started](xref:razor-components/get-started)
# [Build your first app](xref:razor-components/tutorials/first-app)
# [Introduction](xref:razor-components/introduction/index)
# [Components](xref:razor-components/components/index)
# [Component libraries](xref:razor-components/component-libraries)
# [Layouts](xref:razor-components/layouts)
# [Dependency injection](xref:razor-components/dependency-injection)
# [Routing](xref:razor-components/routing)
# [JavaScript interop](xref:razor-components/javascript-interop)
# [Debugging](xref:razor-components/debugging)
# [Hosting models](xref:razor-components/hosting-models)
# [Host and deploy](xref:razor-components/host-and-deploy/index)
## [Configure the Linker](xref:razor-components/host-and-deploy/configure-linker)
# [FAQ](xref:razor-components/introduction/faq)
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/App.cshtml
================================================
<!--
Configuring this here is temporary. Later we'll move the app config
into Program.cs, and it won't be necessary to specify AppAssembly.
-->
<Router AppAssembly=typeof(Program).Assembly />
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/BlazorApp1.csproj
================================================
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netstandard2.0</TargetFramework>
<RunCommand>dotnet</RunCommand>
<RunArguments>blazor serve</RunArguments>
<LangVersion>7.3</LangVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.AspNetCore.Blazor.Browser" Version="0.7.0" />
<PackageReference Include="Microsoft.AspNetCore.Blazor.Build" Version="0.7.0" />
<DotNetCliToolReference Include="Microsoft.AspNetCore.Blazor.Cli" Version="0.7.0" />
</ItemGroup>
</Project>
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/Counter.cshtml
================================================
@page "/counter"
<h1><em>Counter!!</em></h1>
<p>Current count: @currentCount</p>
<button class="btn btn-primary" onclick="@IncrementCount">Click me</button>
@functions {
int currentCount = 0;
[Parameter]
private int IncrementAmount { get; set; } = 1;
void IncrementCount()
{
currentCount+=IncrementAmount;
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/FetchData.cshtml
================================================
@page "/fetchdata"
@inject HttpClient Http
<h1>Weather forecast</h1>
<p>This component demonstrates fetching data from the server.</p>
@if (forecasts == null)
{
<p><em>Loading...</em></p>
}
else
{
<table class="table">
<thead>
<tr>
<th>Date</th>
<th>Temp. (C)</th>
<th>Temp. (F)</th>
<th>Summary</th>
</tr>
</thead>
<tbody>
@foreach (var forecast in forecasts)
{
<tr>
<td>@forecast.Date.ToShortDateString()</td>
<td>@forecast.TemperatureC</td>
<td>@forecast.TemperatureF</td>
<td>@forecast.Summary</td>
</tr>
}
</tbody>
</table>
}
@functions {
WeatherForecast[] forecasts;
protected override async Task OnInitAsync()
{
forecasts = await Http.GetJsonAsync<WeatherForecast[]>("sample-data/weather.json");
}
class WeatherForecast
{
public DateTime Date { get; set; }
public int TemperatureC { get; set; }
public int TemperatureF { get; set; }
public string Summary { get; set; }
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/Index.cshtml
================================================
@page "/"
<h1>Hello, world!</h1>
Welcome to your new app.
<SurveyPrompt Title="How is Blazor working for you?" />
<Counter IncrementAmount="10" />
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/ToDo.cshtml
================================================
@page "/todo"
<h1>Todo (@todos.Where(todo => !todo.IsDone).Count())</h1>
<ul>
@foreach (var todo in todos)
{
<li>
<input type="checkbox" bind="@todo.IsDone" />
<input bind="@todo.Title" />
</li>
}
</ul>
<input placeholder="Something todo" bind="@newTodo" />
<button onclick="@AddTodo">Add todo</button>
@functions {
IList<TodoItem> todos = new List<TodoItem>();
string newTodo;
void AddTodo()
{
if (!string.IsNullOrWhiteSpace(newTodo))
{
todos.Add(new TodoItem { Title = newTodo });
newTodo = string.Empty;
}
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/_ViewImports.cshtml
================================================
@layout MainLayout
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Program.cs
================================================
using Microsoft.AspNetCore.Blazor.Hosting;
namespace BlazorApp1
{
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IWebAssemblyHostBuilder CreateHostBuilder(string[] args) =>
BlazorWebAssemblyHost.CreateDefaultBuilder()
.UseBlazorStartup<Startup>();
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/README.md
================================================
# Build Your First Blazor App Sample (BlazorApp1)
This sample illustrates the basic features of the Blazor app development framework.
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Shared/MainLayout.cshtml
================================================
@inherits BlazorLayoutComponent
<div class="sidebar">
<NavMenu />
</div>
<div class="main">
<div class="top-row px-4">
<a href="http://blazor.net" target="_blank" class="ml-md-auto">About</a>
</div>
<div class="content px-4">
@Body
</div>
</div>
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Shared/NavMenu.cshtml
================================================
<div class="top-row pl-4 navbar navbar-dark">
<a class="navbar-brand" href="">BlazorApp1</a>
<button class="navbar-toggler" onclick=@ToggleNavMenu>
<span class="navbar-toggler-icon"></span>
</button>
</div>
<div class=@(collapseNavMenu ? "collapse" : null) onclick=@ToggleNavMenu>
<ul class="nav flex-column">
<li class="nav-item px-3">
<NavLink class="nav-link" href="" Match=NavLinkMatch.All>
<span class="oi oi-home" aria-hidden="true"></span> Home
</NavLink>
</li>
<li class="nav-item px-3">
<NavLink class="nav-link" href="counter">
<span class="oi oi-plus" aria-hidden="true"></span> Counter
</NavLink>
</li>
<li class="nav-item px-3">
<NavLink class="nav-link" href="fetchdata">
<span class="oi oi-list-rich" aria-hidden="true"></span> Fetch data
</NavLink>
</li>
<li class="nav-item px-3">
<NavLink class="nav-link" href="todo">
<span class="oi oi-list-rich" aria-hidden="true"></span> Todo
</NavLink>
</li>
</ul>
</div>
@functions {
bool collapseNavMenu = true;
void ToggleNavMenu()
{
collapseNavMenu = !collapseNavMenu;
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Shared/SurveyPrompt.cshtml
================================================
<div class="alert alert-secondary mt-4" role="alert">
<span class="oi oi-pencil mr-2" aria-hidden="true"></span>
<strong>@Title</strong>
<span class="text-nowrap">
Please take our
<a target="_blank" class="font-weight-bold" href="https://go.microsoft.com/fwlink/?linkid=873042">
brief survey
</a>
</span>
and tell us what you think.
</div>
@functions {
[Parameter]
string Title { get; set; } // Demonstrates how a parent component can supply parameters
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Startup.cs
================================================
using Microsoft.AspNetCore.Blazor.Builder;
using Microsoft.Extensions.DependencyInjection;
namespace BlazorApp1
{
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
}
public void Configure(IBlazorApplicationBuilder app)
{
app.AddComponent<App>("app");
}
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/TodoItem.cs
================================================
public class TodoItem
{
public string Title { get; set; }
public bool IsDone { get; set; }
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/_ViewImports.cshtml
================================================
@using System.Net.Http
@using Microsoft.AspNetCore.Blazor.Layouts
@using Microsoft.AspNetCore.Blazor.Routing
@using Microsoft.JSInterop
@using BlazorApp1
@using BlazorApp1.Shared
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/open-iconic/FONT-LICENSE
================================================
SIL OPEN FONT LICENSE Version 1.1
Copyright (c) 2014 Waybury
PREAMBLE
The goals of the Open Font License (OFL) are to stimulate worldwide
development of collaborative font projects, to support the font creation
efforts of academic and linguistic communities, and to provide a free and
open framework in which fonts may be shared and improved in partnership
with others.
The OFL allows the licensed fonts to be used, studied, modified and
redistributed freely as long as they are not sold by themselves. The
fonts, including any derivative works, can be bundled, embedded,
redistributed and/or sold with any software provided that any reserved
names are not used by derivative works. The fonts and derivatives,
however, cannot be released under any other type of license. The
requirement for fonts to remain under this license does not apply
to any document created using the fonts or their derivatives.
DEFINITIONS
"Font Software" refers to the set of files released by the Copyright
Holder(s) under this license and clearly marked as such. This may
include source files, build scripts and documentation.
"Reserved Font Name" refers to any names specified as such after the
copyright statement(s).
"Original Version" refers to the collection of Font Software components as
distributed by the Copyright Holder(s).
"Modified Version" refers to any derivative made by adding to, deleting,
or substituting -- in part or in whole -- any of the components of the
Original Version, by changing formats or by porting the Font Software to a
new environment.
"Author" refers to any designer, engineer, programmer, technical
writer or other person who contributed to the Font Software.
PERMISSION & CONDITIONS
Permission is hereby granted, free of charge, to any person obtaining
a copy of the Font Software, to use, study, copy, merge, embed, modify,
redistribute, and sell modified and unmodified copies of the Font
Software, subject to the following conditions:
1) Neither the Font Software nor any of its individual components,
in Original or Modified Versions, may be sold by itself.
2) Original or Modified Versions of the Font Software may be bundled,
redistributed and/or sold with any software, provided that each copy
contains the above copyright notice and this license. These can be
included either as stand-alone text files, human-readable headers or
in the appropriate machine-readable metadata fields within text or
binary files as long as those fields can be easily viewed by the user.
3) No Modified Version of the Font Software may use the Reserved Font
Name(s) unless explicit written permission is granted by the corresponding
Copyright Holder. This restriction only applies to the primary font name as
presented to the users.
4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
Software shall not be used to promote, endorse or advertise any
Modified Version, except to acknowledge the contribution(s) of the
Copyright Holder(s) and the Author(s) or with their explicit written
permission.
5) The Font Software, modified or unmodified, in part or in whole,
must be distributed entirely under this license, and must not be
distributed under any other license. The requirement for fonts to
remain under this license does not apply to any document created
using the Font Software.
TERMINATION
This license becomes null and void if any of the above conditions are
not met.
DISCLAIMER
THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
OTHER DEALINGS IN THE FONT SOFTWARE.
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/open-iconic/ICON-LICENSE
================================================
The MIT License (MIT)
Copyright (c) 2014 Waybury
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/open-iconic/README.md
================================================
[Open Iconic v1.1.1](http://useiconic.com/open)
===========
### Open Iconic is the open source sibling of [Iconic](http://useiconic.com). It is a hyper-legible collection of 223 icons with a tiny footprint—ready to use with Bootstrap and Foundation. [View the collection](http://useiconic.com/open#icons)
## What's in Open Iconic?
* 223 icons designed to be legible down to 8 pixels
* Super-light SVG files - 61.8 for the entire set
* SVG sprite—the modern replacement for icon fonts
* Webfont (EOT, OTF, SVG, TTF, WOFF), PNG and WebP formats
* Webfont stylesheets (including versions for Bootstrap and Foundation) in CSS, LESS, SCSS and Stylus formats
* PNG and WebP raster images in 8px, 16px, 24px, 32px, 48px and 64px.
## Getting Started
#### For code samples and everything else you need to get started with Open Iconic, check out our [Icons](http://useiconic.com/open#icons) and [Reference](http://useiconic.com/open#reference) sections.
### General Usage
#### Using Open Iconic's SVGs
We like SVGs and we think they're the way to display icons on the web. Since Open Iconic are just basic SVGs, we suggest you display them like you would any other image (don't forget the `alt` attribute).
```
<img src="/open-iconic/svg/icon-name.svg" alt="icon name">
```
#### Using Open Iconic's SVG Sprite
Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `<svg>` *tag and a unique class name for each different icon in the* `<use>` *tag.*
```
<svg class="icon">
<use xlink:href="open-iconic.svg#account-login" class="icon-account-login"></use>
</svg>
```
Sizing icons only needs basic CSS. All the icons are in a square format, so just set the `<svg>` tag with equal width and height dimensions.
```
.icon {
width: 16px;
height: 16px;
}
```
Coloring icons is even easier. All you need to do is set the `fill` rule on the `<use>` tag.
```
.icon-account-login {
fill: #f00;
}
```
To learn more about SVG Sprites, read [Chris Coyier's guide](http://css-tricks.com/svg-sprites-use-better-icon-fonts/).
#### Using Open Iconic's Icon Font...
##### …with Bootstrap
You can find our Bootstrap stylesheets in `font/css/open-iconic-bootstrap.{css, less, scss, styl}`
```
<link href="/open-iconic/font/css/open-iconic-bootstrap.css" rel="stylesheet">
```
```
<span class="oi oi-icon-name" title="icon name" aria-hidden="true"></span>
```
##### …with Foundation
You can find our Foundation stylesheets in `font/css/open-iconic-foundation.{css, less, scss, styl}`
```
<link href="/open-iconic/font/css/open-iconic-foundation.css" rel="stylesheet">
```
```
<span class="fi-icon-name" title="icon name" aria-hidden="true"></span>
```
##### …on its own
You can find our default stylesheets in `font/css/open-iconic.{css, less, scss, styl}`
```
<link href="/open-iconic/font/css/open-iconic.css" rel="stylesheet">
```
```
<span class="oi" data-glyph="icon-name" title="icon name" aria-hidden="true"></span>
```
## License
### Icons
All code (including SVG markup) is under the [MIT License](http://opensource.org/licenses/MIT).
### Fonts
All fonts are under the [SIL Licensed](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web).
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/site.css
================================================
@import url('open-iconic/font/css/open-iconic-bootstrap.min.css');
html, body {
font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
}
app {
position: relative;
display: flex;
flex-direction: column;
}
.top-row {
height: 3.5rem;
display: flex;
align-items: center;
}
.main {
flex: 1;
}
.main .top-row {
background-color: #e6e6e6;
border-bottom: 1px solid #d6d5d5;
}
.sidebar {
background-image: linear-gradient(180deg, rgb(5, 39, 103) 0%, #3a0647 70%);
}
.sidebar .top-row {
background-color: rgba(0,0,0,0.4);
}
.sidebar .navbar-brand {
font-size: 1.1rem;
}
.sidebar .oi {
width: 2rem;
font-size: 1.1rem;
vertical-align: text-top;
top: -2px;
}
.nav-item {
font-size: 0.9rem;
padding-bottom: 0.5rem;
}
.nav-item:first-of-type {
padding-top: 1rem;
}
.nav-item:last-of-type {
padding-bottom: 1rem;
}
.nav-item a {
color: #d7d7d7;
border-radius: 4px;
height: 3rem;
display: flex;
align-items: center;
line-height: 3rem;
}
.nav-item a.active {
background-color: rgba(255,255,255,0.25);
color: white;
}
.nav-item a:hover {
background-color: rgba(255,255,255,0.1);
color: white;
}
.content {
padding-top: 1.1rem;
}
.navbar-toggler {
background-color: rgba(255, 255, 255, 0.1);
}
@media (max-width: 767.98px) {
.main .top-row {
display: none;
}
}
@media (min-width: 768px) {
app {
flex-direction: row;
}
.sidebar {
width: 250px;
height: 100vh;
position: sticky;
top: 0;
}
.main .top-row {
position: sticky;
top: 0;
}
.main > div {
padding-left: 2rem !important;
padding-right: 1.5rem !important;
}
.navbar-toggler {
display: none;
}
.sidebar .collapse {
/* Never collapse the sidebar for wide screens */
display: block;
}
}
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/index.html
================================================
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width">
<title>BlazorApp1</title>
<base href="/" />
<link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
<link href="css/site.css" rel="stylesheet" />
</head>
<body>
<app>Loading...</app>
<script src="_framework/blazor.webassembly.js"></script>
</body>
</html>
================================================
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/sample-data/weather.json
================================================
[
{
"date": "2018-05-06",
"temperatureC": 1,
"summary": "Freezing",
"temperatureF": 33
},
{
"date": "2018-05-07",
"temperatureC": 14,
"summary": "Bracing",
"temperatureF": 57
},
{
"date": "2018-05-08",
"temperatureC": -13,
"summary": "Freezing",
"temperatureF": 9
},
{
"date": "2018-05-09",
"temperatureC": -16,
"summary": "Balmy",
"temperatureF": 4
},
{
"date": "2018-05-10",
"temperatureC": -2,
"summary": "Chilly",
"temperatureF": 29
}
]
================================================
FILE: docs/tutorials/build-your-first-blazor-app.md
================================================
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="refresh" content="0; url=https://docs.microsoft.com/aspnet/core/tutorials/build-your-first-blazor-app">
</head>
<body>
</body>
</html>
================================================
FILE: includes/razor-components-preview-notice.md
================================================
> [!NOTE]
> ASP.NET Core Razor Components is supported in ASP.NET Core 3.0 or later.
>
> Blazor is an unsupported experimental web framework that shouldn't be used for production workloads at this time.
================================================
FILE: index.md
================================================
---
title: Welcome to the Blazor preview docs website!
description: Learn about Blazor, an experimental .NET web framework using C#/Razor and HTML that runs in the browser with WebAssembly.
documentType: index
---
<div class="hero">
<div class="wrap">
<h1 class="text">
<strong>Blazor</strong>
</h1>
<div class="minitext">
Full-stack web development with C# and WebAssembly
</div>
<div class="buttons-unit">
<a href="https://docs.microsoft.com/aspnet/core/blazor/get-started" class="button"><i class="glyphicon glyphicon-send"></i>Get Started</a>
</div>
</div>
</div>
<div class="key-section">
<div class="container">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<i class="glyphicon glyphicon-wrench"></i>
<section>
<h2>Build a Web UI with C#</h2>
<p class="lead">Blazor is an experimental .NET web framework using C# and HTML that runs in the browser.</p>
<div class="lead"><a href="https://docs.microsoft.com/aspnet/core/blazor/">What is Blazor?</a></div>
</section>
</div>
</div>
</div>
</div>
<div class="counter-key-section">
<div class="container">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<section>
<h2>Full-stack .NET</h2>
<p class="lead">Do full-stack .NET development using stable and consistent tools, languages, and APIs both in the browser and on the server.</p>
<div class="lead"><a href="https://www.microsoft.com/net">Learn more about the .NET platform</a></div>
</section>
<i class="glyphicon glyphicon-tasks"></i>
</div>
</div>
</div>
</div>
<div class="key-section">
<div class="container content">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<i class="glyphicon glyphicon-globe"></i>
<section>
<h2>Runs in all browsers and implements .NET Standard</h2>
<p class="lead">Blazor runs in all browsers on the real .NET runtime with full support for .NET Standard. Blazor requires no plugins and no code transpilation, only open web standards.</p>
<div class="lead"><a href="https://docs.microsoft.com/aspnet/core/blazor">How Blazor works</a></div>
</section>
</div>
</div>
</div>
</div>
<div class="counter-key-section">
<div class="container">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<section>
<h2>Native performance with WebAssembly</h2>
<p class="lead">Blazor runs on WebAssembly, giving you native performance in the browser and a trusted security sandbox.</p>
</section>
<i class="glyphicon glyphicon-fire"></i>
</div>
</div>
</div>
</div>
<div class="key-section">
<div class="container content">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<i class="glyphicon glyphicon-transfer"></i>
<section>
<h2>Native browser apps</h2>
<p class="lead">Easily interact with your existing JavaScript code, your favorite libraries, and any browser API through JavaScript interop.</p>
</section>
</div>
</div>
</div>
</div>
<div class="counter-key-section">
<div class="container">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<section>
<h2>Simple and productive</h2>
<p class="lead">Get started fast and remain productive with project templates, great tooling, and reusable components.</p>
</section>
<i class="glyphicon glyphicon-console"></i>
</div>
</div>
</div>
</div>
<div class="key-section">
<div class="container content">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<i class="glyphicon glyphicon-user"></i>
<section>
<h2>Get involved</h2>
<p class="lead">Join the community that's building Blazor, writing documentation, building samples, and more!</p>
<div class="lead"><a href="community.md">Community</a></div>
</section>
</div>
</div>
</div>
</div>
<div class="counter-key-section">
<div class="container">
<div class="row">
<div class="col-md-10 col-md-offset-1">
<section>
<h2>Open-source & free </h2>
<p class="lead">Blazor is part of the open-source .NET platform that has a strong community of over 25,000 contributors from over 1,700 companies.</p>
<div class="lead"><a href="https://github.com/aspnet/AspNetCore/tree/master/src/Components">Blazor on GitHub</a></div>
</section>
<i class="glyphicon glyphicon-road"></i>
</div>
</div>
</div>
</div>
<div class="get-started-section">
<div class="container">
<div class="row">
<div class="buttons-unit" style="padding-bottom:50px">
<a href="https://docs.microsoft.com/aspnet/core/blazor/get-started" class="btn btn-primary" style="font-size:2em;display:inline;padding:15px"><i class="glyphicon glyphicon-send" style="font-size:1em;padding:0 20px 0 0"></i>Get Started</a>
</div>
</div>
</div>
</div>
================================================
FILE: releaseDocs.sh
================================================
#!/bin/sh
set -e
export VSINSTALLDIR="C:\Program Files (x86)\Microsoft Visual Studio\2017\Community"
export VisualStudioVersion="15.0"
SOURCE_DIR=$PWD
TEMP_REPO_DIR=$PWD/../blazor-gh-pages
echo "Removing temporary doc directory $TEMP_REPO_DIR"
rm -rf $TEMP_REPO_DIR
mkdir $TEMP_REPO_DIR
echo "Cloning the repo with the gh-pages branch"
git clone https://github.com/aspnet/Blazor.Docs.git --branch gh-pages $TEMP_REPO_DIR
echo "Clear repo directory"
cd $TEMP_REPO_DIR
git rm -r *
echo "Copy documentation into the repo"
cp -r $SOURCE_DIR/_site/* .
cp $SOURCE_DIR/CNAME .
echo "Push the new docs to the remote branch"
git add . -A
git commit -m "Update generated documentation"
git push origin gh-pages
================================================
FILE: src/Microsoft.AspNetCore.Blazor.Browser.xml
================================================
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.AspNetCore.Blazor.Browser</name>
</assembly>
<members>
<member name="T:Microsoft.AspNetCore.Blazor.Builder.BlazorApplicationBuilderExtensions">
<summary>
Provides extension methods for <see cref="T:Microsoft.AspNetCore.Blazor.Builder.IBlazorApplicationBuilder"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Builder.BlazorApplicationBuilderExtensions.AddComponent``1(Microsoft.AspNetCore.Blazor.Builder.IBlazorApplicationBuilder,System.String)">
<summary>
Associates the component type with the application,
causing it to be displayed in the specified DOM element.
</summary>
<param name="app">The <see cref="T:Microsoft.AspNetCore.Blazor.Builder.IBlazorApplicationBuilder"/>.</param>
<typeparam name="TComponent">The type of the component.</typeparam>
<param name="domElementSelector">A CSS selector that uniquely identifies a DOM element.</param>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Builder.IBlazorApplicationBuilder">
<summary>
A builder for constructing a Blazor application.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Builder.IBlazorApplicationBuilder.Services">
<summary>
Gets the application services.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Builder.IBlazorApplicationBuilder.AddComponent(System.Type,System.String)">
<summary>
Associates the <see cref="T:Microsoft.AspNetCore.Blazor.Components.IComponent"/> with the application,
causing it to be displayed in the specified DOM element.
</summary>
<param name="componentType">The type of the component.</param>
<param name="domElementSelector">A CSS selector that uniquely identifies a DOM element.</param>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Hosting.BlazorWebAssemblyHost">
<summary>
Used to to create instances a Blazor host builder for a Browser application.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.BlazorWebAssemblyHost.CreateDefaultBuilder">
<summary>
Creates a an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/>.
</summary>
<returns>The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/>.</returns>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost">
<summary>
A program abstraction.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost.Services">
<summary>
The programs configured services.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost.StartAsync(System.Threading.CancellationToken)">
<summary>
Start the program.
</summary>
<param name="cancellationToken">Used to abort program start.</param>
<returns></returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost.StopAsync(System.Threading.CancellationToken)">
<summary>
Attempts to gracefully stop the program.
</summary>
<param name="cancellationToken">Used to indicate when stop should no longer be graceful.</param>
<returns></returns>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder">
<summary>
Abstraction for configuring a Blazor browser-based application.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder.Properties">
<summary>
A central location for sharing state between components during the host building process.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder.ConfigureServices(System.Action{Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderContext,Microsoft.Extensions.DependencyInjection.IServiceCollection})">
<summary>
Adds services to the container. This can be called multiple times and the results will be additive.
</summary>
<param name="configureDelegate">The delegate for configuring the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> that will be used
to construct the <see cref="T:System.IServiceProvider"/>.</param>
<returns>The same instance of the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/> for chaining.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder.Build">
<summary>
Run the given actions to initialize the host. This can only be called once.
</summary>
<returns>An initialized <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost"/></returns>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilder.Properties">
<summary>
A central location for sharing state between components during the host building process.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilder.ConfigureServices(System.Action{Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderContext,Microsoft.Extensions.DependencyInjection.IServiceCollection})">
<summary>
Adds services to the container. This can be called multiple times and the results will be additive.
</summary>
<param name="configureDelegate"></param>
<returns>The same instance of the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/> for chaining.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilder.Build">
<summary>
Run the given actions to initialize the host. This can only be called once.
</summary>
<returns>An initialized <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost"/></returns>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderContext">
<summary>
Context containing the common services on the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost" />. Some properties may be null until set by the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost" />.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderContext.#ctor(System.Collections.Generic.IDictionary{System.Object,System.Object})">
<summary>
Creates a new <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderContext" />.
</summary>
<param name="properties">The property collection.</param>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderContext.Properties">
<summary>
A central location for sharing state between components during the host building process.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderExtensions">
<summary>
Provides Blazor-specific support for <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderExtensions.ConfigureServices(Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder,System.Action{Microsoft.Extensions.DependencyInjection.IServiceCollection})">
<summary>
Adds services to the container. This can be called multiple times and the results will be additive.
</summary>
<param name="hostBuilder">The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder" /> to configure.</param>
<param name="configureDelegate"></param>
<returns>The same instance of the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/> for chaining.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderExtensions.UseBlazorStartup(Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder,System.Type)">
<summary>
Configures the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/> to use the provided startup class.
</summary>
<param name="builder">The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/>.</param>
<param name="startupType">A type that configures a Blazor application.</param>
<returns>The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/>.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostBuilderExtensions.UseBlazorStartup``1(Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder)">
<summary>
Configures the <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/> to use the provided startup class.
</summary>
<typeparam name="TStartup">A type that configures a Blazor application.</typeparam>
<param name="builder">The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/>.</param>
<returns>The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHostBuilder"/>.</returns>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostExtensions">
<summary>
Extension methods for <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostExtensions.Run(Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost)">
<summary>
Runs the application.
</summary>
<param name="host">The <see cref="T:Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost"/> to run.</param>
<remarks>
Currently, Blazor applications running in the browser don't have a lifecycle - the application does not
get a chance to gracefully shut down. For now, <see cref="M:Microsoft.AspNetCore.Blazor.Hosting.WebAssemblyHostExtensions.Run(Microsoft.AspNetCore.Blazor.Hosting.IWebAssemblyHost)"/> simply starts the host
and allows execution to continue.
</remarks>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Http.BrowserHttpMessageHandler">
<summary>
A browser-compatible implementation of <see cref="T:System.Net.Http.HttpMessageHandler"/>
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Browser.Http.BrowserHttpMessageHandler.DefaultCredentials">
<summary>
Gets or sets the default value of the 'credentials' option on outbound HTTP requests.
Defaults to <see cref="F:Microsoft.AspNetCore.Blazor.Browser.Http.FetchCredentialsOption.SameOrigin"/>.
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Browser.Http.BrowserHttpMessageHandler.FetchArgs">
<summary>
The name of a well-known property that can be added to <see cref="P:System.Net.Http.HttpRequestMessage.Properties"/>
to control the arguments passed to the underlying JavaScript <code>fetch</code> API.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Http.BrowserHttpMessageHandler.SendAsync(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)">
<inheritdoc />
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Http.FetchCredentialsOption">
<summary>
Specifies a value for the 'credentials' option on outbound HTTP requests.
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Browser.Http.FetchCredentialsOption.Omit">
<summary>
Advises the browser never to send credentials (such as cookies or HTTP auth headers).
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Browser.Http.FetchCredentialsOption.SameOrigin">
<summary>
Advises the browser to send credentials (such as cookies or HTTP auth headers)
only if the target URL is on the same origin as the calling application.
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Browser.Http.FetchCredentialsOption.Include">
<summary>
Advises the browser to send credentials (such as cookies or HTTP auth headers)
even for cross-origin requests.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer">
<summary>
Provides mechanisms for rendering <see cref="T:Microsoft.AspNetCore.Blazor.Components.IComponent"/> instances in a
web browser, dispatching events to them, and refreshing the UI as required.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer.#ctor">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer.#ctor(System.IServiceProvider)">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer"/>.
</summary>
<param name="serviceProvider">The <see cref="T:System.IServiceProvider"/> to use when initializing components.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer.AddComponent``1(System.String)">
<summary>
Attaches a new root component to the renderer,
causing it to be displayed in the specified DOM element.
</summary>
<typeparam name="TComponent">The type of the component.</typeparam>
<param name="domElementSelector">A CSS selector that uniquely identifies a DOM element.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer.AddComponent(System.Type,System.String)">
<summary>
Associates the <see cref="T:Microsoft.AspNetCore.Blazor.Components.IComponent"/> with the <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer"/>,
causing it to be displayed in the specified DOM element.
</summary>
<param name="componentType">The type of the component.</param>
<param name="domElementSelector">A CSS selector that uniquely identifies a DOM element.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer.Dispose">
<summary>
Disposes the instance.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer.UpdateDisplayAsync(Microsoft.AspNetCore.Blazor.Rendering.RenderBatch@)">
<inheritdoc />
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher">
<summary>
Provides mechanisms for dispatching events to components in a <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer"/>.
This is marked 'internal' because it only gets invoked from JS code.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.DispatchEvent(Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.BrowserEventDescriptor,System.String)">
<summary>
For framework use only.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.BrowserEventDescriptor">
<summary>
For framework use only.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.BrowserEventDescriptor.BrowserRendererId">
<summary>
For framework use only.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.BrowserEventDescriptor.ComponentId">
<summary>
For framework use only.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.BrowserEventDescriptor.EventHandlerId">
<summary>
For framework use only.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRendererEventDispatcher.BrowserEventDescriptor.EventArgsType">
<summary>
For framework use only.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Services.ActivateMonoJSRuntime">
<summary>
Temporary mechanism for registering the Mono JS runtime. Developers do not need to
use this directly, and it will be removed shortly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.ActivateMonoJSRuntime.EnsureActivated">
<summary>
Temporary mechanism for registering the Mono JS runtime. Developers do not need to
use this directly, and it will be removed shortly.
The return value is intended to be used with GC.KeepAlive purely as a way of ensuring
the invocation doesn't get stripped out by the linker (if it's smart enough to do so).
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserServiceProvider">
<summary>
An implementation of <see cref="T:System.IServiceProvider"/> configured with
default services suitable for use in a browser environment.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserServiceProvider.#ctor">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserServiceProvider"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserServiceProvider.#ctor(System.Action{Microsoft.Extensions.DependencyInjection.IServiceCollection})">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserServiceProvider"/>.
</summary>
<param name="configure">A callback that can be used to configure the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserServiceProvider.GetService(System.Type)">
<inheritdoc />
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper">
<summary>
Default browser implementation of <see cref="T:Microsoft.AspNetCore.Blazor.Services.IUriHelper"/>.
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper.Instance">
<summary>
Gets the instance of <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper.InitializeState">
<summary>
Called to initialize BaseURI and current URI before those values the first time.
Override this method to dynamically calculate the those values.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper.NavigateToCore(System.String)">
<inheritdoc />
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper.NotifyLocationChanged(System.String)">
<summary>
For framework use only.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Services.BrowserUriHelper.ToBaseUri(System.String)">
<summary>
Given the document's document.baseURI value, returns the URI
that can be prepended to relative URI paths to produce an absolute URI.
This is computed by removing anything after the final slash.
Internal for tests.
</summary>
<param name="absoluteBaseUri">The page's document.baseURI value.</param>
<returns>The URI prefix</returns>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry">
<summary>
Framework infrastructure, not intended to be used by application code.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry.Current">
<summary>
Framework infrastructure, not intended to be used by application code.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry.SetCurrentRendererRegistry(Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry)">
<summary>
Framework infrastructure, not intended by used by application code.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry.Add(Microsoft.AspNetCore.Blazor.Rendering.Renderer)">
<summary>
Framework infrastructure, not intended by used by application code.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry.Find(System.Int32)">
<summary>
Framework infrastructure, not intended by used by application code.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry.TryRemove(System.Int32)">
<summary>
Framework infrastructure, not intended by used by application code.
</summary>
</member>
</members>
</doc>
================================================
FILE: src/Microsoft.AspNetCore.Blazor.Server.xml
================================================
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.AspNetCore.Blazor.Server</name>
</assembly>
<members>
<member name="T:Microsoft.AspNetCore.Builder.BlazorOptions">
<summary>
Provides configuration options to the <see cref="M:Microsoft.AspNetCore.Builder.BlazorApplicationBuilderExtensions.UseBlazor(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Builder.BlazorOptions)"/>
middleware.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Builder.BlazorOptions.ClientAssemblyPath">
<summary>
Full path to the client assembly.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Builder.BlazorApplicationBuilderExtensions">
<summary>
Provides extension methods that add Blazor-related middleware to the ASP.NET pipeline.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Builder.BlazorApplicationBuilderExtensions.UseBlazor``1(Microsoft.AspNetCore.Builder.IApplicationBuilder)">
<summary>
Configures the middleware pipeline to work with Blazor.
</summary>
<typeparam name="TProgram">Any type from the client app project. This is used to identify the client app assembly.</typeparam>
<param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>
<returns>The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Builder.BlazorApplicationBuilderExtensions.UseBlazor(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Builder.BlazorOptions)">
<summary>
Configures the middleware pipeline to work with Blazor.
</summary>
<param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>
<param name="options">Options to configure the middleware.</param>
<returns>The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</returns>
</member>
<member name="T:Microsoft.AspNetCore.Builder.ServerSideBlazorApplicationBuilderExtensions">
<summary>
Extension methods to configure an <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/> for Server-Side Blazor.
These are just shorthand for combining UseSignalR with UseBlazor.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Builder.ServerSideBlazorApplicationBuilderExtensions.UseServerSideBlazor``1(Microsoft.AspNetCore.Builder.IApplicationBuilder)">
<summary>
Registers Server-Side Blazor in the pipeline.
</summary>
<param name="builder">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>
<typeparam name="TStartup">A Blazor startup type.</typeparam>
<returns>The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Builder.ServerSideBlazorApplicationBuilderExtensions.UseServerSideBlazor(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Builder.BlazorOptions)">
<summary>
Registers Server-Side Blazor in the pipeline.
</summary>
<param name="builder">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>
<param name="options">A <see cref="T:Microsoft.AspNetCore.Builder.BlazorOptions"/> instance used to configure the Blazor file provider.</param>
<returns>The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</returns>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.AutoRebuild.IRebuildService">
<summary>
Represents a mechanism for rebuilding a .NET project. For example, it
could be a way of signalling to a VS process to perform a build.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.AutoRebuild.VSForWindowsRebuildService">
<summary>
Finds the VS process that launched this app process (if any), and uses
named pipes to communicate with its AutoRebuild listener (if any).
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.BlazorHub">
<summary>
A SignalR hub that accepts connections to a Server-Side Blazor app.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.BlazorHub.#ctor(Microsoft.Extensions.Logging.ILogger{Microsoft.AspNetCore.Blazor.Server.BlazorHub},System.IServiceProvider)">
<summary>
Intended for framework use only. Applications should not instantiate
this class directly.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Server.BlazorHub.DefaultPath">
<summary>
Gets the default endpoint path for incoming connections.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.BlazorHub.OnDisconnectedAsync(System.Exception)">
<summary>
Intended for framework use only. Applications should not call this method directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.BlazorHub.StartCircuit(System.String,System.String)">
<summary>
Intended for framework use only. Applications should not call this method directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.BlazorHub.BeginInvokeDotNetFromJS(System.String,System.String,System.String,System.Int64,System.String)">
<summary>
Intended for framework use only. Applications should not call this method directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.BlazorHub.OnRenderCompleted(System.Int64,System.String)">
<summary>
Intended for framework use only. Applications should not call this method directly.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.Circuits.AutoCancelTaskCompletionSource`1">
<summary>
Behaves like a <see cref="T:System.Threading.Tasks.TaskCompletionSource`1"/>, but automatically times out
the underlying task after a given period if not already completed.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.Circuits.Circuit">
<summary>
Represents an active connection between a Blazor server and a client.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Server.Circuits.Circuit.Current">
<summary>
Gets the current <see cref="T:Microsoft.AspNetCore.Blazor.Server.Circuits.Circuit"/>.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Server.Circuits.Circuit.JSRuntime">
<summary>
Gets the <see cref="T:Microsoft.JSInterop.IJSRuntime"/> associated with this circuit.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Server.Circuits.Circuit.Services">
<summary>
Gets the <see cref="T:System.IServiceProvider"/> associated with this circuit.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.Current">
<summary>
Gets the current <see cref="P:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.Circuit"/>, if any.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.SetCurrentCircuitHost(Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost)">
<summary>
Sets the current <see cref="P:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.Circuit"/>.
</summary>
<param name="circuitHost">The <see cref="P:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.Circuit"/>.</param>
<remarks>
Calling <see cref="M:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.SetCurrentCircuitHost(Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost)"/> will store the circuit
and other related values such as the <see cref="T:Microsoft.JSInterop.IJSRuntime"/> and <see cref="P:Microsoft.AspNetCore.Blazor.Server.Circuits.CircuitHost.Renderer"/>
in the local execution context. Application code should not need to call this method,
it is primarily used by the Server-Side Blazor infrastructure.
</remarks>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.Circuits.MessagePackBufferStream">
<summary>
Provides Stream APIs for writing to a MessagePack-supplied expandable buffer.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper">
<summary>
A Server-Side Blazor implementation of <see cref="T:Microsoft.AspNetCore.Blazor.Services.IUriHelper"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper.#ctor(Microsoft.JSInterop.IJSRuntime)">
<summary>
Creates a new <see cref="T:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper"/>.
</summary>
<param name="jsRuntime"></param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper.Initialize(System.String,System.String)">
<summary>
Initializes the <see cref="T:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper"/>.
</summary>
<param name="uriAbsolute">The absolute URI of the current page.</param>
<param name="baseUriAbsolute">The absolute base URI of the current page.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper.NotifyLocationChanged(System.String)">
<summary>
For framework use only.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Server.Circuits.RemoteUriHelper.NavigateToCore(System.String)">
<summary>
Navigates to the specified URI.
</summary>
<param name="uri">The destination URI. This can be absolute, or relative to the base URI
(as returned by <see cref="M:Microsoft.AspNetCore.Blazor.Services.IUriHelper.GetBaseUri"/>).</param>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.Circuits.RenderBatchFormatterResolver">
<summary>
A MessagePack IFormatterResolver that provides an efficient binary serialization
of <see cref="T:Microsoft.AspNetCore.Blazor.Rendering.RenderBatch"/>. The client-side code knows how to walk through this
binary representation directly, without it first being parsed as an object graph.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.Circuits.RenderBatchWriter">
<summary>
Provides a custom binary serializer for <see cref="T:Microsoft.AspNetCore.Blazor.Rendering.RenderBatch"/> instances.
This is designed with both server-side and client-side perf in mind:
* Array-like regions always have a fixed size per entry (even if some entry types
don't require as much space as others) so the recipient can index directly.
* The indices describing where field data starts, where each string value starts,
etc., are written *after* that data, so when writing the data we don't have to
compute the locations up front or seek back to an earlier point in the stream.
The recipient can only process the data after reading it all into a buffer,
so it's no disadvantage for the location info to be at the end.
* We only serialize the data that the JS side will need. For example, we don't
emit frame sequence numbers, or any representation of nonstring attribute
values, or component instances, etc.
We don't have or need a .NET reader for this format. We only read it from JS code.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.WasmMediaTypeNames">
<summary>
Contains values for WASM-related media types.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Server.WasmMediaTypeNames.Application">
<summary>
Contains values for WASM-related media types within the "application." namespace
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Server.WasmMediaTypeNames.Application.Wasm">
<summary>
The standard media type name for WebAssembly binary files.
</summary>
</member>
<member name="E:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer.UnhandledException">
<summary>
Notifies when a rendering exception occured.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer.#ctor(System.IServiceProvider,Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry,Microsoft.JSInterop.IJSRuntime,Microsoft.AspNetCore.SignalR.IClientProxy,System.Threading.SynchronizationContext)">
<summary>
Creates a new <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer"/>.
</summary>
<param name="serviceProvider">The <see cref="T:System.IServiceProvider"/>.</param>
<param name="rendererRegistry">The <see cref="T:Microsoft.AspNetCore.Blazor.Rendering.RendererRegistry"/>.</param>
<param name="jsRuntime">The <see cref="T:Microsoft.JSInterop.IJSRuntime"/>.</param>
<param name="client">The <see cref="T:Microsoft.AspNetCore.SignalR.IClientProxy"/>.</param>
<param name="syncContext">A <see cref="T:System.Threading.SynchronizationContext"/> that can be used to serialize renderer operations.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer.AddComponent``1(System.String)">
<summary>
Attaches a new root component to the renderer,
causing it to be displayed in the specified DOM element.
</summary>
<typeparam name="TComponent">The type of the component.</typeparam>
<param name="domElementSelector">A CSS selector that uniquely identifies a DOM element.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer.AddComponent(System.Type,System.String)">
<summary>
Associates the <see cref="T:Microsoft.AspNetCore.Blazor.Components.IComponent"/> with the <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.BrowserRenderer"/>,
causing it to be displayed in the specified DOM element.
</summary>
<param name="componentType">The type of the component.</param>
<param name="domElementSelector">A CSS selector that uniquely identifies a DOM element.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer.Dispose">
<summary>
Disposes the instance.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRenderer.UpdateDisplayAsync(Microsoft.AspNetCore.Blazor.Rendering.RenderBatch@)">
<inheritdoc />
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRendererException">
<summary>
Represents an exception related to remote rendering.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRendererException.#ctor(System.String)">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Browser.Rendering.RemoteRendererException"/>.
</summary>
<param name="message">The exception message.</param>
</member>
<member name="T:Microsoft.Extensions.DependencyInjection.ServerSideBlazorServiceCollectionExtensions">
<summary>
Extension methods to configure an <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> for Server-Side Blazor.
</summary>
</member>
<member name="M:Microsoft.Extensions.DependencyInjection.ServerSideBlazorServiceCollectionExtensions.AddServerSideBlazor(Microsoft.Extensions.DependencyInjection.IServiceCollection)">
<summary>
Adds Server-Side Blazor services to the service collection.
</summary>
<param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param>
<returns>The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</returns>
</member>
<member name="M:Microsoft.Extensions.DependencyInjection.ServerSideBlazorServiceCollectionExtensions.AddServerSideBlazor(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Type)">
<summary>
Adds Server-Side Blazor services to the service collection.
</summary>
<param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param>
<param name="startupType">A Blazor startup type.</param>
<returns>The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</returns>
</member>
<member name="M:Microsoft.Extensions.DependencyInjection.ServerSideBlazorServiceCollectionExtensions.AddServerSideBlazor``1(Microsoft.Extensions.DependencyInjection.IServiceCollection)">
<summary>
Adds Server-Side Blazor services to the service collection.
</summary>
<param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param>
<typeparam name="TStartup">A Blazor startup type.</typeparam>
<returns>The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</returns>
</member>
</members>
</doc>
================================================
FILE: src/Microsoft.AspNetCore.Blazor.xml
================================================
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.AspNetCore.Blazor</name>
</assembly>
<members>
<member name="T:Microsoft.AspNetCore.Blazor.Components.BindAttributes">
<summary>
Infrastructure for the discovery of <c>bind</c> attributes for markup elements.
</summary>
<remarks>
To extend the set of <c>bind</c> attributes, define a public class named
<c>BindAttributes</c> and annotate it with the appropriate attributes.
</remarks>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute">
<summary>
Configures options for binding specific element types.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute.#ctor(System.String,System.String,System.String,System.String)">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute"/>.
</summary>
<param name="element">The tag name of the element.</param>
<param name="suffix">The suffix value. For example, set this to <code>value</code> for <code>bind-value</code>, or set this to <code>null</code> for <code>bind</code>.</param>
<param name="valueAttribute">The name of the value attribute to be bound.</param>
<param name="changeAttribute">The name of an attribute that will register an associated change event.</param>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute.Element">
<summary>
Gets the tag name of the element.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute.Suffix">
<summary>
Gets the suffix value.
For example, this will be <code>value</code> to mean <code>bind-value</code>, or <code>null</code> to mean <code>bind</code>.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute.ValueAttribute">
<summary>
Gets the name of the value attribute to be bound.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindElementAttribute.ChangeAttribute">
<summary>
Gets the name of an attribute that will register an associated change event.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute">
<summary>
Configures options for binding subtypes of an HTML <code>input</code> element.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute.#ctor(System.String,System.String,System.String,System.String)">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute"/>.
</summary>
<param name="type">The value of the element's <code>type</code> attribute.</param>
<param name="suffix">The suffix value.</param>
<param name="valueAttribute">The name of the value attribute to be bound.</param>
<param name="changeAttribute">The name of an attribute that will register an associated change event.</param>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute.Type">
<summary>
Gets the value of the element's <code>type</code> attribute.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute.Suffix">
<summary>
Gets the suffix value.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute.ValueAttribute">
<summary>
Gets the name of the value attribute to be bound.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.BindInputElementAttribute.ChangeAttribute">
<summary>
Gets the name of an attribute that will register an associated change event.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Components.BindMethods">
<summary>
Methods used internally by @bind syntax. Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetValue``1(``0)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetValue(System.DateTime,System.String)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetEventHandlerValue``1(System.String)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetEventHandlerValue``1(System.Action)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetEventHandlerValue``1(System.Func{System.Threading.Tasks.Task})">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetEventHandlerValue``1(System.Action{``0})">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.GetEventHandlerValue``1(System.Func{``0,System.Threading.Tasks.Task})">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.String},System.String)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.Boolean},System.Boolean)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.Int32},System.Int32)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.Int64},System.Int64)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.Single},System.Single)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.Double},System.Double)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.Decimal},System.Decimal)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.DateTime},System.DateTime)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler(System.Action{System.DateTime},System.DateTime,System.String)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BindMethods.SetValueHandler``1(System.Action{``0},``0)">
<summary>
Not intended to be used directly.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Components.BlazorComponent">
<summary>
Optional base class for Blazor components. Alternatively, Blazor components may
implement <see cref="T:Microsoft.AspNetCore.Blazor.Components.IComponent"/> directly.
</summary>
</member>
<member name="F:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.BuildRenderTreeMethodName">
<summary>
Specifies the name of the <see cref="N:Microsoft.AspNetCore.Blazor.RenderTree"/>-building method.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.#ctor">
<summary>
Constructs an instance of <see cref="T:Microsoft.AspNetCore.Blazor.Components.BlazorComponent"/>.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.BuildRenderTree(Microsoft.AspNetCore.Blazor.RenderTree.RenderTreeBuilder)">
<summary>
Renders the component to the supplied <see cref="T:Microsoft.AspNetCore.Blazor.RenderTree.RenderTreeBuilder"/>.
</summary>
<param name="builder">A <see cref="T:Microsoft.AspNetCore.Blazor.RenderTree.RenderTreeBuilder"/> that will receive the render output.</param>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.OnInit">
<summary>
Method invoked when the component is ready to start, having received its
initial parameters from its parent in the render tree.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.OnInitAsync">
<summary>
Method invoked when the component is ready to start, having received its
initial parameters from its parent in the render tree.
Override this method if you will perform an asynchronous operation and
want the component to refresh when that operation is completed.
</summary>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> representing any asynchronous operation.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.OnParametersSet">
<summary>
Method invoked when the component has received parameters from its parent in
the render tree, and the incoming values have been assigned to properties.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.OnParametersSetAsync">
<summary>
Method invoked when the component has received parameters from its parent in
the render tree, and the incoming values have been assigned to properties.
</summary>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> representing any asynchronous operation.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.StateHasChanged">
<summary>
Notifies the component that its state has changed. When applicable, this will
cause the component to be re-rendered.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.ShouldRender">
<summary>
Returns a flag to indicate whether the component should render.
</summary>
<returns></returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.OnAfterRender">
<summary>
Method invoked after each time the component has been rendered.
</summary>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.OnAfterRenderAsync">
<summary>
Method invoked after each time the component has been rendered. Note that the component does
not automatically re-render after the completion of any returned <see cref="T:System.Threading.Tasks.Task"/>, because
that would cause an infinite render loop.
</summary>
<returns>A <see cref="T:System.Threading.Tasks.Task"/> representing any asynchronous operation.</returns>
</member>
<member name="M:Microsoft.AspNetCore.Blazor.Components.BlazorComponent.SetParameters(Microsoft.AspNetCore.Blazor.Components.ParameterCollection)">
<summary>
Method invoked to apply initial or updated parameters to the component.
</summary>
<param name="parameters">The parameters to apply.</param>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Components.CascadingParameterAttribute">
<summary>
Denotes the target member as a cascading component parameter. Its value will be
supplied by the closest ancestor <see cref="T:Microsoft.AspNetCore.Blazor.Components.CascadingValue`1"/> component that
supplies values with a compatible type and name.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.CascadingParameterAttribute.Name">
<summary>
If specified, the parameter value will be supplied by the closest
ancestor <see cref="T:Microsoft.AspNetCore.Blazor.Components.CascadingValue`1"/> that supplies a value with
this name.
If null, the parameter value will be supplied by the closest ancestor
<see cref="T:Microsoft.AspNetCore.Blazor.Components.CascadingValue`1"/> that supplies a value with a compatible
type.
</summary>
</member>
<member name="T:Microsoft.AspNetCore.Blazor.Components.CascadingValue`1">
<summary>
A component that provides a cascading value to all descendant components.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.CascadingValue`1.ChildContent">
<summary>
The content to which the value should be provided.
</summary>
</member>
<member name="P:Microsoft.AspNetCore.Blazor.Components.CascadingValue`1.Value">
<summary>
The value to be provided.
</summary>
</member>
<member name=
gitextract_t_iy0_rr/ ├── .gitattributes ├── .github/ │ ├── ISSUE_TEMPLATE.md │ └── PULL_REQUEST_TEMPLATE.md ├── .gitignore ├── CNAME ├── CONTRIBUTING.md ├── LICENSE ├── LICENSE-CODE ├── README.md ├── ThirdPartyNotices ├── api/ │ ├── .gitignore │ └── index.md ├── appveyor.yml ├── community.md ├── docfx.json ├── docs/ │ ├── common/ │ │ └── samples/ │ │ └── 3.x/ │ │ └── BlazorSample/ │ │ ├── App.cshtml │ │ ├── BlazorSample.csproj │ │ ├── Components/ │ │ │ ├── ListViewTemplate.cshtml │ │ │ ├── Tab.cshtml │ │ │ ├── TabSet.cshtml │ │ │ └── TableTemplate.cshtml │ │ ├── JsInteropClasses/ │ │ │ ├── ExampleJsInterop.cs │ │ │ └── HelloHelper.cs │ │ ├── Pages/ │ │ │ ├── BlazorRocks.cshtml │ │ │ ├── BlazorRocksBase.cs │ │ │ ├── BlazorRoute.cshtml │ │ │ ├── CascadingValuesParametersTabSet.cshtml │ │ │ ├── CascadingValuesParametersTheme.cshtml │ │ │ ├── ChildComponent.cshtml │ │ │ ├── FetchData.cshtml │ │ │ ├── HeadingComponent.cshtml │ │ │ ├── Index.cshtml │ │ │ ├── JSInterop.cshtml │ │ │ ├── ParentComponent.cshtml │ │ │ ├── RazorTemplates.cshtml │ │ │ ├── RouteParameter.cshtml │ │ │ ├── TemplatedComponents.cshtml │ │ │ └── _ViewImports.cshtml │ │ ├── Program.cs │ │ ├── README.md │ │ ├── Shared/ │ │ │ ├── CascadingValuesParametersLayout.cshtml │ │ │ ├── MainLayout.cshtml │ │ │ └── NavMenu.cshtml │ │ ├── Startup.cs │ │ ├── UIInterfaces/ │ │ │ └── ITab.cs │ │ ├── UIThemeClasses/ │ │ │ └── ThemeInfo.cs │ │ ├── _ViewImports.cshtml │ │ └── wwwroot/ │ │ ├── css/ │ │ │ └── site.css │ │ ├── exampleJsInterop.js │ │ ├── index.html │ │ └── sample-data/ │ │ └── weather.json │ ├── component-libraries.md │ ├── components/ │ │ └── index.md │ ├── debugging.md │ ├── dependency-injection.md │ ├── get-started.md │ ├── host-and-deploy/ │ │ ├── configure-linker.md │ │ └── index.md │ ├── hosting-models/ │ │ └── samples_snapshot/ │ │ └── Startup.cs │ ├── hosting-models.md │ ├── index.md │ ├── introduction/ │ │ ├── faq.md │ │ └── index.md │ ├── javascript-interop.md │ ├── layouts.md │ ├── routing.md │ ├── toc.md │ └── tutorials/ │ ├── build-your-first-blazor-app/ │ │ └── samples/ │ │ └── 3.x/ │ │ └── BlazorApp1/ │ │ ├── App.cshtml │ │ ├── BlazorApp1.csproj │ │ ├── Pages/ │ │ │ ├── Counter.cshtml │ │ │ ├── FetchData.cshtml │ │ │ ├── Index.cshtml │ │ │ ├── ToDo.cshtml │ │ │ └── _ViewImports.cshtml │ │ ├── Program.cs │ │ ├── README.md │ │ ├── Shared/ │ │ │ ├── MainLayout.cshtml │ │ │ ├── NavMenu.cshtml │ │ │ └── SurveyPrompt.cshtml │ │ ├── Startup.cs │ │ ├── TodoItem.cs │ │ ├── _ViewImports.cshtml │ │ └── wwwroot/ │ │ ├── css/ │ │ │ ├── open-iconic/ │ │ │ │ ├── FONT-LICENSE │ │ │ │ ├── ICON-LICENSE │ │ │ │ ├── README.md │ │ │ │ └── font/ │ │ │ │ └── fonts/ │ │ │ │ └── open-iconic.otf │ │ │ └── site.css │ │ ├── index.html │ │ └── sample-data/ │ │ └── weather.json │ └── build-your-first-blazor-app.md ├── includes/ │ └── razor-components-preview-notice.md ├── index.md ├── releaseDocs.sh ├── src/ │ ├── Microsoft.AspNetCore.Blazor.Browser.xml │ ├── Microsoft.AspNetCore.Blazor.Server.xml │ ├── Microsoft.AspNetCore.Blazor.xml │ └── Microsoft.JSInterop.xml ├── template/ │ ├── index.html.tmpl │ └── styles/ │ └── main.css └── toc.yml
SYMBOL INDEX (26 symbols across 11 files)
FILE: docs/common/samples/3.x/BlazorSample/JsInteropClasses/ExampleJsInterop.cs
class ExampleJsInterop (line 11) | public class ExampleJsInterop
method Prompt (line 13) | public static Task<string> Prompt(string text)
method Display (line 21) | public static Task<string> Display(string welcomeMessage)
method CallHelloHelperSayHello (line 29) | public static Task CallHelloHelperSayHello(string name)
FILE: docs/common/samples/3.x/BlazorSample/JsInteropClasses/HelloHelper.cs
class HelloHelper (line 10) | public class HelloHelper
method HelloHelper (line 12) | public HelloHelper(string name)
method SayHello (line 19) | [JSInvokable]
FILE: docs/common/samples/3.x/BlazorSample/Pages/BlazorRocksBase.cs
class BlazorRocksBase (line 3) | public class BlazorRocksBase : BlazorComponent
FILE: docs/common/samples/3.x/BlazorSample/Program.cs
class Program (line 5) | public class Program
method Main (line 7) | public static void Main(string[] args)
method CreateHostBuilder (line 12) | public static IWebAssemblyHostBuilder CreateHostBuilder(string[] args) =>
FILE: docs/common/samples/3.x/BlazorSample/Startup.cs
class Startup (line 5) | public class Startup
method ConfigureServices (line 7) | public void ConfigureServices(IServiceCollection services)
method Configure (line 11) | public void Configure(IBlazorApplicationBuilder app)
FILE: docs/common/samples/3.x/BlazorSample/UIInterfaces/ITab.cs
type ITab (line 5) | public interface ITab
FILE: docs/common/samples/3.x/BlazorSample/UIThemeClasses/ThemeInfo.cs
class ThemeInfo (line 8) | public class ThemeInfo
FILE: docs/hosting-models/samples_snapshot/Startup.cs
class Startup (line 1) | public class Startup
method ConfigureServices (line 3) | public void ConfigureServices(IServiceCollection services)
method Configure (line 17) | public void Configure(IApplicationBuilder app, IHostingEnvironment env)
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Program.cs
class Program (line 5) | public class Program
method Main (line 7) | public static void Main(string[] args)
method CreateHostBuilder (line 12) | public static IWebAssemblyHostBuilder CreateHostBuilder(string[] args) =>
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Startup.cs
class Startup (line 6) | public class Startup
method ConfigureServices (line 8) | public void ConfigureServices(IServiceCollection services)
method Configure (line 12) | public void Configure(IBlazorApplicationBuilder app)
FILE: docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/TodoItem.cs
class TodoItem (line 1) | public class TodoItem
Condensed preview — 100 files, each showing path, character count, and a content snippet. Download the .json file or copy for the full structured content (373K chars).
[
{
"path": ".gitattributes",
"chars": 2534,
"preview": "###############################################################################\n# Set default behavior to automatically "
},
{
"path": ".github/ISSUE_TEMPLATE.md",
"chars": 729,
"preview": "\n\n<!--\nGeneral\n\nWe use issues to drive the discussion for changes to existing topics and the creation of new topics. Thi"
},
{
"path": ".github/PULL_REQUEST_TEMPLATE.md",
"chars": 395,
"preview": "\n\n<!--\nWhen creating a new PR, please delete this template text and reference the issue number.\n\nTo automatically close "
},
{
"path": ".gitignore",
"chars": 3269,
"preview": "_build/\n_site/\nProperties/\n\n# Use git add -f to force override .sln when required. Not needed in most cases.\n# git add -"
},
{
"path": "CNAME",
"chars": 11,
"preview": "blazor.net\n"
},
{
"path": "CONTRIBUTING.md",
"chars": 7140,
"preview": "# Contributing to the Blazor documentation\n\nThis document covers the process for contributing to the articles and code s"
},
{
"path": "LICENSE",
"chars": 18646,
"preview": "Attribution 4.0 International\n\n=======================================================================\n\nCreative Commons"
},
{
"path": "LICENSE-CODE",
"chars": 1090,
"preview": "The MIT License (MIT)\nCopyright (c) Microsoft Corporation\n\nPermission is hereby granted, free of charge, to any person o"
},
{
"path": "README.md",
"chars": 338,
"preview": "# Blazor Docs\n\nThe Blazor docs have moved to the https://github.com/aspnet/AspNetCore.Docs repo and are published at htt"
},
{
"path": "ThirdPartyNotices",
"chars": 1133,
"preview": "##Legal Notices\nMicrosoft and any contributors grant you a license to the Microsoft documentation and other content\nin t"
},
{
"path": "api/.gitignore",
"chars": 54,
"preview": "###############\n# temp file #\n###############\n*.yml\n"
},
{
"path": "api/index.md",
"chars": 257,
"preview": "---\ntitle: Blazor API\ndescription: Find information on the Blazor API.\nuid: api\n---\n# Blazor API\n\n[!INCLUDE[](~/includes"
},
{
"path": "appveyor.yml",
"chars": 472,
"preview": "skip_tags: true\n\nimage: Visual Studio 2017\n\nclone_depth: 1\n\nbranches:\n only:\n - live\n\ninstall:\n - cinst docfx --ver"
},
{
"path": "community.md",
"chars": 22153,
"preview": "# Blazor community resources\n\n[!INCLUDE[](~/includes/razor-components-preview-notice.md)]\n\nBelow is a list of projects a"
},
{
"path": "docfx.json",
"chars": 1159,
"preview": "{\n \"metadata\": [\n {\n \"src\": [\n {\n \"files\": [\n \"src/**.dll\"\n ]\n }\n "
},
{
"path": "docs/common/samples/3.x/BlazorSample/App.cshtml",
"chars": 201,
"preview": "<!--\n Configuring this here is temporary. Later we'll move the app config\n into Program.cs, and it won't be neces"
},
{
"path": "docs/common/samples/3.x/BlazorSample/BlazorSample.csproj",
"chars": 551,
"preview": "<Project Sdk=\"Microsoft.NET.Sdk.Web\">\n\n <PropertyGroup>\n <TargetFramework>netstandard2.0</TargetFramework>\n <Run"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Components/ListViewTemplate.cshtml",
"chars": 240,
"preview": "@typeparam TItem\n\n<ul>\n @foreach (var item in Items)\n {\n @ItemTemplate(item)\n }\n</ul>\n\n@functions {\n "
},
{
"path": "docs/common/samples/3.x/BlazorSample/Components/Tab.cshtml",
"chars": 706,
"preview": "@using BlazorSample.UIInterfaces\n@implements IDisposable\n@implements ITab\n\n<li>\n <a onclick=@Activate class=\"nav-lin"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Components/TabSet.cshtml",
"chars": 841,
"preview": "@using BlazorSample.UIInterfaces\n\n<!-- Display the tab headers -->\n<CascadingValue Value=this>\n <ul class=\"nav nav-t"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Components/TableTemplate.cshtml",
"chars": 532,
"preview": "@typeparam TItem\n\n<table class=\"table\">\n <thead>\n <tr>@TableHeader</tr>\n </thead>\n <tbody>\n @fore"
},
{
"path": "docs/common/samples/3.x/BlazorSample/JsInteropClasses/ExampleJsInterop.cs",
"chars": 1183,
"preview": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Net;\nusing System.Threading.Tasks;\nusin"
},
{
"path": "docs/common/samples/3.x/BlazorSample/JsInteropClasses/HelloHelper.cs",
"chars": 452,
"preview": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Threading.Tasks;\nusing Microsoft.JSInte"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/BlazorRocks.cshtml",
"chars": 831,
"preview": "@page \"/BlazorRocks\"\n@*\n The inherit directive provides the properties and methods\n of the BlazorRocksBase class t"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/BlazorRocksBase.cs",
"chars": 177,
"preview": "using Microsoft.AspNetCore.Blazor.Components;\n\npublic class BlazorRocksBase : BlazorComponent\n{\n public string Blazor"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/BlazorRoute.cshtml",
"chars": 418,
"preview": "@page \"/BlazorRoute\"\n@page \"/DifferentBlazorRoute\"\n\n<h1>Blazor routing</h1>\n\n<p>\n Reach this page component on two ro"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/CascadingValuesParametersTabSet.cshtml",
"chars": 4384,
"preview": "@page \"/CascadingValuesParametersTabSet\"\n\n<h1>Cascading Values & Parameters - TabSet</h1>\n\n<!-- <snippet_TabSet> -->\n<Ta"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/CascadingValuesParametersTheme.cshtml",
"chars": 2013,
"preview": "@page \"/cascadingvaluesparameterstheme\"\n@layout CascadingValuesParametersLayout\n@using BlazorSample.UIThemeClasses\n\n<h1"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/ChildComponent.cshtml",
"chars": 275,
"preview": "<div class=\"panel panel-success\">\n <div class=\"panel-heading\">@Title</div>\n <div class=\"panel-body\">@ChildContent<"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/FetchData.cshtml",
"chars": 2185,
"preview": "@page \"/fetchdata\"\n@page \"/fetchdata/{StartDate:datetime}\"\n@inject HttpClient Http\n\n<h1>Weather forecast</h1>\n\n<p>This c"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/HeadingComponent.cshtml",
"chars": 1698,
"preview": "@using System.Globalization\n@*\n The 'using' directive makes System.Globalization available to \n the component. Sys"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/Index.cshtml",
"chars": 2047,
"preview": "@page \"/\"\n@*\n The page directive indicates this component is available as a page \n at the root of the app, the \"/"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/JSInterop.cshtml",
"chars": 3338,
"preview": "@page \"/JSInterop\"\n@using BlazorSample.JsInteropClasses\n@using Microsoft.JSInterop;\n\n<h1>JavaScript Interop</h1>\n\n<h2>In"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/ParentComponent.cshtml",
"chars": 1275,
"preview": "@page \"/ParentComponent\"\n\n<h1>Parent-child example</h1>\n\n<ChildComponent Title=\"Panel Title from Parent\">\n Child cont"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/RazorTemplates.cshtml",
"chars": 1418,
"preview": "@page \"/RazorTemplates\"\n\n<h1>Razor Templates</h1>\n\n<p>Render fragments can be defined using Razor template syntax. Razor"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/RouteParameter.cshtml",
"chars": 787,
"preview": "@page \"/RouteParameter\"\n@page \"/RouteParameter/{text}\"\n\n<h1>Blazor is @Text!</h1>\n\n@functions {\n [Parameter]\n priv"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/TemplatedComponents.cshtml",
"chars": 3683,
"preview": "@page \"/TemplatedComponents\"\n\n<h1>Templated Components</h1>\n\n<p>Templated components are components that accept one or m"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Pages/_ViewImports.cshtml",
"chars": 20,
"preview": "@layout MainLayout\n"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Program.cs",
"chars": 413,
"preview": "using Microsoft.AspNetCore.Blazor.Hosting;\n\nnamespace BlazorSample\n{\n public class Program\n {\n public stat"
},
{
"path": "docs/common/samples/3.x/BlazorSample/README.md",
"chars": 108,
"preview": "# Blazor Sample\n\nThis sample illustrates the use of Blazor scenarios described in the Blazor documentation.\n"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Shared/CascadingValuesParametersLayout.cshtml",
"chars": 506,
"preview": "@inherits BlazorLayoutComponent\n@using BlazorSample.UIThemeClasses\n\n<div class=\"container-fluid\">\n <div class=\"row\">"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Shared/MainLayout.cshtml",
"chars": 238,
"preview": "@inherits BlazorLayoutComponent\n\n<div class=\"container-fluid\">\n <div class=\"row\">\n <div class=\"col-sm-3\">\n "
},
{
"path": "docs/common/samples/3.x/BlazorSample/Shared/NavMenu.cshtml",
"chars": 3372,
"preview": "<div class=\"main-nav\">\n <div class=\"navbar navbar-inverse\">\n <div class=\"navbar-header\">\n <button "
},
{
"path": "docs/common/samples/3.x/BlazorSample/Startup.cs",
"chars": 320,
"preview": "using BlazorSample;\nusing Microsoft.AspNetCore.Blazor.Builder;\nusing Microsoft.Extensions.DependencyInjection;\n\npublic c"
},
{
"path": "docs/common/samples/3.x/BlazorSample/UIInterfaces/ITab.cs",
"chars": 160,
"preview": "using Microsoft.AspNetCore.Blazor;\n\nnamespace BlazorSample.UIInterfaces\n{\n public interface ITab\n {\n Rende"
},
{
"path": "docs/common/samples/3.x/BlazorSample/UIThemeClasses/ThemeInfo.cs",
"chars": 228,
"preview": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Threading.Tasks;\n\nnamespace BlazorSampl"
},
{
"path": "docs/common/samples/3.x/BlazorSample/_ViewImports.cshtml",
"chars": 238,
"preview": "@using System.Net.Http\n@using Microsoft.AspNetCore.Blazor\n@using Microsoft.AspNetCore.Blazor.Components\n@using Microsof"
},
{
"path": "docs/common/samples/3.x/BlazorSample/wwwroot/css/site.css",
"chars": 2576,
"preview": ".main-nav li .glyphicon {\n margin-right: 10px;\n}\n\n/* Highlighting rules for nav menu items */\n.main-nav li a.active,"
},
{
"path": "docs/common/samples/3.x/BlazorSample/wwwroot/exampleJsInterop.js",
"chars": 563,
"preview": "window.exampleJsFunctions = {\n showPrompt: function (text) {\n return prompt(text, 'Type your name here');\n },\n di"
},
{
"path": "docs/common/samples/3.x/BlazorSample/wwwroot/index.html",
"chars": 527,
"preview": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-widt"
},
{
"path": "docs/common/samples/3.x/BlazorSample/wwwroot/sample-data/weather.json",
"chars": 587,
"preview": "[\n {\n \"dateFormatted\": \"06/05/2018\",\n \"temperatureC\": 1,\n \"summary\": \"Freezing\",\n \"temperatureF\": 33\n },\n"
},
{
"path": "docs/component-libraries.md",
"chars": 172,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/components/index.md",
"chars": 167,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/debugging.md",
"chars": 162,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/dependency-injection.md",
"chars": 177,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/get-started.md",
"chars": 168,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/host-and-deploy/configure-linker.md",
"chars": 189,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/host"
},
{
"path": "docs/host-and-deploy/index.md",
"chars": 173,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/host"
},
{
"path": "docs/hosting-models/samples_snapshot/Startup.cs",
"chars": 796,
"preview": "public class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n services.AddServerSi"
},
{
"path": "docs/hosting-models.md",
"chars": 171,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/index.md",
"chars": 157,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/introduction/faq.md",
"chars": 157,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/introduction/index.md",
"chars": 157,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/javascript-interop.md",
"chars": 175,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/layouts.md",
"chars": 164,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/routing.md",
"chars": 164,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/blaz"
},
{
"path": "docs/toc.md",
"chars": 819,
"preview": "# [Get started](xref:razor-components/get-started)\n# [Build your first app](xref:razor-components/tutorials/first-app)\n#"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/App.cshtml",
"chars": 201,
"preview": "<!--\n Configuring this here is temporary. Later we'll move the app config\n into Program.cs, and it won't be neces"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/BlazorApp1.csproj",
"chars": 551,
"preview": "<Project Sdk=\"Microsoft.NET.Sdk.Web\">\n\n <PropertyGroup>\n <TargetFramework>netstandard2.0</TargetFramework>\n <Run"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/Counter.cshtml",
"chars": 349,
"preview": "@page \"/counter\"\n\n<h1><em>Counter!!</em></h1>\n\n<p>Current count: @currentCount</p>\n\n<button class=\"btn btn-primary\" onc"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/FetchData.cshtml",
"chars": 1235,
"preview": "@page \"/fetchdata\"\n@inject HttpClient Http\n\n<h1>Weather forecast</h1>\n\n<p>This component demonstrates fetching data fro"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/Index.cshtml",
"chars": 152,
"preview": "@page \"/\"\n\n<h1>Hello, world!</h1>\n\nWelcome to your new app.\n\n<SurveyPrompt Title=\"How is Blazor working for you?\" />\n\n<"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/ToDo.cshtml",
"chars": 638,
"preview": "@page \"/todo\"\n\n<h1>Todo (@todos.Where(todo => !todo.IsDone).Count())</h1>\n\n<ul>\n @foreach (var todo in todos)\n {\n "
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Pages/_ViewImports.cshtml",
"chars": 20,
"preview": "@layout MainLayout\n"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Program.cs",
"chars": 411,
"preview": "using Microsoft.AspNetCore.Blazor.Hosting;\n\nnamespace BlazorApp1\n{\n public class Program\n {\n public static"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/README.md",
"chars": 135,
"preview": "# Build Your First Blazor App Sample (BlazorApp1)\n\nThis sample illustrates the basic features of the Blazor app developm"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Shared/MainLayout.cshtml",
"chars": 286,
"preview": "@inherits BlazorLayoutComponent\n\n<div class=\"sidebar\">\n <NavMenu />\n</div>\n\n<div class=\"main\">\n <div class=\"top-r"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Shared/NavMenu.cshtml",
"chars": 1317,
"preview": "<div class=\"top-row pl-4 navbar navbar-dark\">\n <a class=\"navbar-brand\" href=\"\">BlazorApp1</a>\n <button class=\"nav"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Shared/SurveyPrompt.cshtml",
"chars": 523,
"preview": "<div class=\"alert alert-secondary mt-4\" role=\"alert\">\n <span class=\"oi oi-pencil mr-2\" aria-hidden=\"true\"></span> \n "
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/Startup.cs",
"chars": 365,
"preview": "using Microsoft.AspNetCore.Blazor.Builder;\nusing Microsoft.Extensions.DependencyInjection;\n\nnamespace BlazorApp1\n{\n p"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/TodoItem.cs",
"chars": 101,
"preview": "public class TodoItem\n{\n public string Title { get; set; }\n public bool IsDone { get; set; }\n}\n"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/_ViewImports.cshtml",
"chars": 180,
"preview": "@using System.Net.Http\n@using Microsoft.AspNetCore.Blazor.Layouts\n@using Microsoft.AspNetCore.Blazor.Routing\n@using Mic"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/open-iconic/FONT-LICENSE",
"chars": 4017,
"preview": "SIL OPEN FONT LICENSE Version 1.1\n\nCopyright (c) 2014 Waybury\n\nPREAMBLE\nThe goals of the Open Font License (OFL) are to "
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/open-iconic/ICON-LICENSE",
"chars": 1073,
"preview": "The MIT License (MIT)\n\nCopyright (c) 2014 Waybury\n\nPermission is hereby granted, free of charge, to any person obtaining"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/open-iconic/README.md",
"chars": 3495,
"preview": "[Open Iconic v1.1.1](http://useiconic.com/open)\n===========\n\n### Open Iconic is the open source sibling of [Iconic](http"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/css/site.css",
"chars": 2125,
"preview": "@import url('open-iconic/font/css/open-iconic-bootstrap.min.css');\n\nhtml, body {\n font-family: 'Helvetica Neue', Hel"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/index.html",
"chars": 405,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta charset=\"utf-8\" />\n <meta name=\"viewport\" content=\"width=device-width\">\n <"
},
{
"path": "docs/tutorials/build-your-first-blazor-app/samples/3.x/BlazorApp1/wwwroot/sample-data/weather.json",
"chars": 542,
"preview": "[\n {\n \"date\": \"2018-05-06\",\n \"temperatureC\": 1,\n \"summary\": \"Freezing\",\n \"temperatureF\": 33\n },\n {\n \""
},
{
"path": "docs/tutorials/build-your-first-blazor-app.md",
"chars": 187,
"preview": "<!DOCTYPE html>\n<html>\n<head>\n <meta http-equiv=\"refresh\" content=\"0; url=https://docs.microsoft.com/aspnet/core/tuto"
},
{
"path": "includes/razor-components-preview-notice.md",
"chars": 203,
"preview": "> [!NOTE]\n> ASP.NET Core Razor Components is supported in ASP.NET Core 3.0 or later.\n>\n> Blazor is an unsupported experi"
},
{
"path": "index.md",
"chars": 5150,
"preview": "---\ntitle: Welcome to the Blazor preview docs website!\ndescription: Learn about Blazor, an experimental .NET web framewo"
},
{
"path": "releaseDocs.sh",
"chars": 708,
"preview": "#!/bin/sh\nset -e\n\nexport VSINSTALLDIR=\"C:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\Community\"\nexport VisualStudi"
},
{
"path": "src/Microsoft.AspNetCore.Blazor.Browser.xml",
"chars": 23693,
"preview": "<?xml version=\"1.0\"?>\n<doc>\n <assembly>\n <name>Microsoft.AspNetCore.Blazor.Browser</name>\n </assembly>\n "
},
{
"path": "src/Microsoft.AspNetCore.Blazor.Server.xml",
"chars": 19142,
"preview": "<?xml version=\"1.0\"?>\n<doc>\n <assembly>\n <name>Microsoft.AspNetCore.Blazor.Server</name>\n </assembly>\n <"
},
{
"path": "src/Microsoft.AspNetCore.Blazor.xml",
"chars": 151833,
"preview": "<?xml version=\"1.0\"?>\n<doc>\n <assembly>\n <name>Microsoft.AspNetCore.Blazor</name>\n </assembly>\n <members"
},
{
"path": "src/Microsoft.JSInterop.xml",
"chars": 26742,
"preview": "<?xml version=\"1.0\"?>\n<doc>\n <assembly>\n <name>Microsoft.JSInterop</name>\n </assembly>\n <members>\n "
},
{
"path": "template/index.html.tmpl",
"chars": 644,
"preview": "{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root fo"
},
{
"path": "template/styles/main.css",
"chars": 4693,
"preview": "body {\n font-size: 16px;\n}\n\n.toc .level1 > li {\n font-weight: normal;\n}\n\nh1, h2 {\n font-family: segoe-ui_light,Segoe "
},
{
"path": "toc.yml",
"chars": 235,
"preview": "- name: Docs\n href: https://docs.microsoft.com/aspnet/core/blazor/\n- name: API\n href: api/\n homepage: api/index.md\n- "
}
]
// ... and 1 more files (download for full content)
About this extraction
This page contains the full source code of the aspnet/Blazor.Docs GitHub repository, extracted and formatted as plain text for AI agents and large language models (LLMs). The extraction includes 100 files (345.5 KB), approximately 82.4k tokens, and a symbol index with 26 extracted functions, classes, methods, constants, and types. Use this with OpenClaw, Claude, ChatGPT, Cursor, Windsurf, or any other AI tool that accepts text input. You can copy the full output to your clipboard or download it as a .txt file.
Extracted by GitExtract — free GitHub repo to text converter for AI. Built by Nikandr Surkov.