Skip to content

Commit

Permalink
Update generated documentation for version 1.3.40
Browse files Browse the repository at this point in the history
  • Loading branch information
Thorium committed Jun 27, 2024
1 parent 678f005 commit 3866ef3
Show file tree
Hide file tree
Showing 72 changed files with 981 additions and 876 deletions.
15 changes: 7 additions & 8 deletions core/general.html
Original file line number Diff line number Diff line change
Expand Up @@ -389,7 +389,7 @@ <h2><a name="Basic-Querying" class="anchor" href="#Basic-Querying">Basic Queryin
<h2><a name="Individuals" class="anchor" href="#Individuals">Individuals</a></h2>
<p>The SQL provider has the ability via intellisense to navigate the actual data
held within a table or view. You can then bind that data as an entity to a value.</p>
<pre class="fssnip highlighted"><code lang="fsharp"><span class="k">let</span> <span onmouseout="hideTip(event, 'fs48', 151)" onmouseover="showTip(event, 'fs48', 151)" class="id">BERGS</span> <span class="o">=</span> <span onmouseout="hideTip(event, 'fs16', 152)" onmouseover="showTip(event, 'fs16', 152)" class="id">ctx</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs21', 153)" onmouseover="showTip(event, 'fs21', 153)" class="prop">Main</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 154)" onmouseover="showTip(event, 'fs22', 154)" class="prop">Customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs49', 155)" onmouseover="showTip(event, 'fs49', 155)" class="prop">Individuals</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs50', 156)" onmouseover="showTip(event, 'fs50', 156)" class="id">BERGS</span>
<pre class="fssnip highlighted"><code lang="fsharp"><span class="k">let</span> <span onmouseout="hideTip(event, 'fs48', 151)" onmouseover="showTip(event, 'fs48', 151)" class="id">BERGS</span> <span class="o">=</span> <span onmouseout="hideTip(event, 'fs16', 152)" onmouseover="showTip(event, 'fs16', 152)" class="id">ctx</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs21', 153)" onmouseover="showTip(event, 'fs21', 153)" class="prop">Main</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 154)" onmouseover="showTip(event, 'fs22', 154)" class="prop">Customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs49', 155)" onmouseover="showTip(event, 'fs49', 155)" class="prop">Individuals</span><span class="pn">.</span><span class="id">BERGS</span>
</code></pre>
<p>Every table and view has an <code>Individuals</code> property. When you press dot on
this property, intellisense will display a list of the data in that table,
Expand All @@ -402,7 +402,7 @@ <h2><a name="Individuals" class="anchor" href="#Individuals">Individuals</a></h2
is the name of a column in the table.
When you press . on one of these properties, the data is re-projected to you
using both the primary key and the text of the column you have selected.</p>
<pre class="fssnip highlighted"><code lang="fsharp"><span class="k">let</span> <span onmouseout="hideTip(event, 'fs51', 157)" onmouseover="showTip(event, 'fs51', 157)" class="id">christina</span> <span class="o">=</span> <span onmouseout="hideTip(event, 'fs16', 158)" onmouseover="showTip(event, 'fs16', 158)" class="id">ctx</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs21', 159)" onmouseover="showTip(event, 'fs21', 159)" class="prop">Main</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 160)" onmouseover="showTip(event, 'fs22', 160)" class="prop">Customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs49', 161)" onmouseover="showTip(event, 'fs49', 161)" class="prop">Individuals</span><span class="pn">.</span><span class="prop">``As ContactName``</span><span class="pn">.</span><span class="id">``BERGS, Christina Berglund``</span>
<pre class="fssnip highlighted"><code lang="fsharp"><span class="k">let</span> <span onmouseout="hideTip(event, 'fs50', 156)" onmouseover="showTip(event, 'fs50', 156)" class="id">christina</span> <span class="o">=</span> <span onmouseout="hideTip(event, 'fs16', 157)" onmouseover="showTip(event, 'fs16', 157)" class="id">ctx</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs21', 158)" onmouseover="showTip(event, 'fs21', 158)" class="prop">Main</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 159)" onmouseover="showTip(event, 'fs22', 159)" class="prop">Customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs49', 160)" onmouseover="showTip(event, 'fs49', 160)" class="prop">Individuals</span><span class="pn">.</span><span class="id">``As ContactName``</span><span class="pn">.</span><span class="id">``BERGS, Christina Berglund``</span>
</code></pre>
<h2><a name="DataContext" class="anchor" href="#DataContext">DataContext</a></h2>
<p>You should create and use one data context as long as it has the parameters you need.
Expand All @@ -423,7 +423,7 @@ <h2><a name="DataContext" class="anchor" href="#DataContext">DataContext</a></h2
<p>A. Once SQLProvider gets a "mental model" of your database (the schema),
that is what is used for any intellisense/completion suggestions for the rest of your IDE session.</p>
<pre class="fssnip highlighted"><code lang="fsharp"><span class="id">This</span> <span class="id">is</span> <span class="id">a</span> <span class="id">fantastic</span> <span class="id">feature</span><span class="pn">,</span> <span class="id">because</span> <span class="id">it</span> <span class="id">means</span> <span class="id">that</span> <span class="id">you&#39;re</span> <span class="id">not</span> <span class="id">assaulting</span> <span class="id">your</span> <span class="id">database</span> <span class="k">with</span> <span class="id">a</span>
<span class="k">new</span> <span class="s">&quot;What are you like?&quot;</span> <span onmouseout="hideTip(event, 'fs30', 162)" onmouseover="showTip(event, 'fs30', 162)" class="id">query</span> <span class="id">on</span> <span class="id">EVERY</span> <span class="id">SINGLE</span> <span class="id">KEYSTROKE</span><span class="pn">.</span>
<span class="k">new</span> <span class="s">&quot;What are you like?&quot;</span> <span onmouseout="hideTip(event, 'fs30', 161)" onmouseover="showTip(event, 'fs30', 161)" class="id">query</span> <span class="id">on</span> <span class="id">EVERY</span> <span class="id">SINGLE</span> <span class="id">KEYSTROKE</span><span class="pn">.</span>

<span class="id">But</span> <span class="id">what</span> <span class="k">if</span> <span class="id">the</span> <span class="id">database</span> <span class="id">changes</span><span class="o">?</span> <span class="id">SQLProvider</span> <span class="id">will</span> <span class="id">NOT</span> <span class="id">see</span> <span class="id">your</span> <span class="id">change</span> <span class="id">because</span> <span class="id">it&#39;s</span> <span class="id">source</span> <span class="k">of</span> <span class="id">truth</span> <span class="id">is</span>
<span class="id">that</span> <span class="id">locally</span> <span class="id">cached</span> <span class="id">schema</span> <span class="id">snapshot</span> <span class="id">it</span> <span class="id">took</span> <span class="id">right</span> <span class="k">when</span> <span class="id">it</span> <span class="id">started</span><span class="pn">,</span> <span class="k">and</span> <span class="id">that</span> <span class="id">snapshot</span> <span class="id">will</span> <span class="id">persist</span> <span class="id">until</span>
Expand All @@ -436,7 +436,7 @@ <h2><a name="DataContext" class="anchor" href="#DataContext">DataContext</a></h2
<span class="n">2.</span> <span class="id">Forced</span> <span class="id">clearing</span> <span class="k">of</span> <span class="id">the</span> <span class="id">local</span> <span class="id">database</span> <span class="id">schema</span> <span class="id">cache</span><span class="pn">.</span>
<span class="id">If</span> <span class="id">SQLProvider</span> <span class="id">is</span> <span class="id">currently</span> <span class="id">able</span> <span class="k">to</span> <span class="id">communicate</span> <span class="k">with</span> <span class="id">the</span> <span class="id">database</span><span class="pn">,</span>
<span class="id">you</span> <span class="id">can</span> <span class="id">force</span> <span class="id">the</span> <span class="id">local</span> <span class="id">cache</span> <span class="k">to</span> <span class="id">clear</span><span class="pn">,</span> <span class="k">to</span> <span class="id">be</span> <span class="id">invalidated</span> <span class="k">and</span> <span class="id">refreshed</span> <span class="id">by</span>
<span class="id">by</span> <span onmouseout="hideTip(event, 'fs52', 163)" onmouseover="showTip(event, 'fs52', 163)" class="id">using</span> <span class="id">what</span> <span class="id">are</span> <span class="id">called</span> <span class="id">`</span><span class="id">Design</span> <span class="id">Time</span> <span class="id">Commands</span><span class="id">`</span><span class="pn">,</span> <span class="id">specifically</span> <span class="id">the</span>
<span class="id">by</span> <span onmouseout="hideTip(event, 'fs51', 162)" onmouseover="showTip(event, 'fs51', 162)" class="id">using</span> <span class="id">what</span> <span class="id">are</span> <span class="id">called</span> <span class="id">`</span><span class="id">Design</span> <span class="id">Time</span> <span class="id">Commands</span><span class="id">`</span><span class="pn">,</span> <span class="id">specifically</span> <span class="id">the</span>
<span class="id">`</span><span class="id">ClearDatabaseSchemaCache</span><span class="id">`</span> <span class="id">method</span><span class="pn">.</span>

<span class="id">You&#39;re</span> <span class="id">probably</span> <span class="id">thinking</span><span class="pn">:</span> <span class="s">&quot;Ok, fine, that sounds good! How do I do that though?&quot;</span>
Expand Down Expand Up @@ -640,11 +640,10 @@ <h2><a name="How-fast-is-SQLProvider" class="anchor" href="#How-fast-is-SQLProvi
<div class="fsdocs-tip" id="fs45">val ordersQuery: (string * System.DateTime * string) array</div>
<div class="fsdocs-tip" id="fs46">property SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity.OrderDate: System.DateTime with get, set<br /><em>&lt;summary&gt;OrderDate: datetime&lt;/summary&gt;</em></div>
<div class="fsdocs-tip" id="fs47">property SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity.ShipAddress: string with get, set<br /><em>&lt;summary&gt;ShipAddress: nvarchar(60)&lt;/summary&gt;</em></div>
<div class="fsdocs-tip" id="fs48">val BERGS: SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity</div>
<div class="fsdocs-tip" id="fs48">val BERGS: obj</div>
<div class="fsdocs-tip" id="fs49">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Customers.Individuals: SqlDataProvider&lt;...&gt;.dataContext.main.Customers.Individuals with get<br /><em>&lt;summary&gt;Get individual items from the table. Requires single primary key.&lt;/summary&gt;</em></div>
<div class="fsdocs-tip" id="fs50">property SqlDataProvider&lt;...&gt;.dataContext.main.Customers.Individuals.BERGS: SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity with get</div>
<div class="fsdocs-tip" id="fs51">val christina: SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity</div>
<div class="fsdocs-tip" id="fs52">val using: resource: &#39;T -&gt; action: (&#39;T -&gt; &#39;U) -&gt; &#39;U (requires &#39;T :&gt; System.IDisposable)</div>
<div class="fsdocs-tip" id="fs50">val christina: obj</div>
<div class="fsdocs-tip" id="fs51">val using: resource: &#39;T -&gt; action: (&#39;T -&gt; &#39;U) -&gt; &#39;U (requires &#39;T :&gt; System.IDisposable)</div>

</div>
</main>
Expand Down
7 changes: 3 additions & 4 deletions core/individuals.html
Original file line number Diff line number Diff line change
Expand Up @@ -266,13 +266,13 @@ <h1><a name="Individuals" class="anchor" href="#Individuals">Individuals</a></h1
<span class="k">let</span> <span onmouseout="hideTip(event, 'fs19', 25)" onmouseover="showTip(event, 'fs19', 25)" class="id">customers</span> <span class="o">=</span> <span onmouseout="hideTip(event, 'fs17', 26)" onmouseover="showTip(event, 'fs17', 26)" class="id">ctx</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs20', 27)" onmouseover="showTip(event, 'fs20', 27)" class="prop">Main</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs21', 28)" onmouseover="showTip(event, 'fs21', 28)" class="id">Customers</span>
</code></pre>
<p>Get individual customer row by primary key value</p>
<pre class="fssnip highlighted"><code lang="fsharp"><span onmouseout="hideTip(event, 'fs19', 29)" onmouseover="showTip(event, 'fs19', 29)" class="id">customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 30)" onmouseover="showTip(event, 'fs22', 30)" class="prop">Individuals</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs23', 31)" onmouseover="showTip(event, 'fs23', 31)" class="id">COMMI</span>
<pre class="fssnip highlighted"><code lang="fsharp"><span onmouseout="hideTip(event, 'fs19', 29)" onmouseover="showTip(event, 'fs19', 29)" class="id">customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 30)" onmouseover="showTip(event, 'fs22', 30)" class="prop">Individuals</span><span class="pn">.</span><span class="id">COMMI</span>
</code></pre>
<p>Get individual customer row using address</p>
<pre class="fssnip highlighted"><code lang="fsharp"><span onmouseout="hideTip(event, 'fs19', 32)" onmouseover="showTip(event, 'fs19', 32)" class="id">customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 33)" onmouseover="showTip(event, 'fs22', 33)" class="prop">Individuals</span><span class="pn">.</span><span class="prop">``As ContactName``</span><span class="pn">.</span><span class="id">``COMMI, Pedro Afonso``</span>
<pre class="fssnip highlighted"><code lang="fsharp"><span onmouseout="hideTip(event, 'fs19', 31)" onmouseover="showTip(event, 'fs19', 31)" class="id">customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 32)" onmouseover="showTip(event, 'fs22', 32)" class="prop">Individuals</span><span class="pn">.</span><span class="id">``As ContactName``</span><span class="pn">.</span><span class="id">``COMMI, Pedro Afonso``</span>
</code></pre>
<p>Get individual customer row using address</p>
<pre class="fssnip highlighted"><code lang="fsharp"><span onmouseout="hideTip(event, 'fs19', 34)" onmouseover="showTip(event, 'fs19', 34)" class="id">customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 35)" onmouseover="showTip(event, 'fs22', 35)" class="prop">Individuals</span><span class="pn">.</span><span class="prop">``As Address``</span><span class="pn">.</span><span class="id">``CONSH, Berkeley Gardens 12 Brewery``</span>
<pre class="fssnip highlighted"><code lang="fsharp"><span onmouseout="hideTip(event, 'fs19', 33)" onmouseover="showTip(event, 'fs19', 33)" class="id">customers</span><span class="pn">.</span><span onmouseout="hideTip(event, 'fs22', 34)" onmouseover="showTip(event, 'fs22', 34)" class="prop">Individuals</span><span class="pn">.</span><span class="id">``As Address``</span><span class="pn">.</span><span class="id">``CONSH, Berkeley Gardens 12 Brewery``</span>
</code></pre>

<div class="fsdocs-tip" id="fs1">Multiple items<br />type LiteralAttribute =
Expand Down Expand Up @@ -336,7 +336,6 @@ <h1><a name="Individuals" class="anchor" href="#Individuals">Individuals</a></h1
<div class="fsdocs-tip" id="fs20">property SqlDataProvider&lt;...&gt;.dataContext.Main: SqlDataProvider&lt;...&gt;.dataContext.mainSchema with get</div>
<div class="fsdocs-tip" id="fs21">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.Customers: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Customers with get<br /><em>&lt;summary&gt; The table Customers belonging to schema main&lt;/summary&gt;</em></div>
<div class="fsdocs-tip" id="fs22">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Customers.Individuals: SqlDataProvider&lt;...&gt;.dataContext.main.Customers.Individuals with get<br /><em>&lt;summary&gt;Get individual items from the table. Requires single primary key.&lt;/summary&gt;</em></div>
<div class="fsdocs-tip" id="fs23">property SqlDataProvider&lt;...&gt;.dataContext.main.Customers.Individuals.COMMI: SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity with get</div>

</div>
</main>
Expand Down
Loading

0 comments on commit 3866ef3

Please sign in to comment.