</ iframe > </noscript> <!-- End Google Tag Manager (noscript) --> <div id="BeforeHeaderContent"> </div> <div id="HeaderContent"> <div id="ProjectTitle">TileControl for WinForms</div> <div id="PageTitle"><div id="PageTitleText">Property Mapping</div></div> </div> <div id="AfterHeaderContent"> <!-- Spacing --> <span id="ToggleAllSectionsLink" class="FunctionLink"> <label id="CollapseAllLabel">Collapse All</label> <label id="ExpandAllLabel" style="display: none;">Expand All</label> </span> </div> <div class="BreadcrumbsContainer"><table><tr><td> <a href="Data Binding Overview.html">Data Binding Overview</a> > Property Mapping</td></tr></table></div> <div id="BodyContent"> <p class="MsoBodyText">The <b style="mso-bidi-font-weight: normal;">C1.Win.C1Tile.Tile</b> component uses the <span class="LinkClass">PropertyMapping</span> class to create an association between the property of an item from the data source and the property of the corresponding <b style="mso-bidi-font-weight: normal;">C1.Win.C1Tile.Tile</b> component.</p> <p class="MsoBodyText">The <span class="LinkClass">PropertyMapping</span> class includes the following members:</p> <p class="MsoBodyText"> </p> <table> <tbody> <tr> <th>Property</th> <th>Description</th> </tr> <tr> <td> <p><b>PropertyMapping.Comment</b></p> </td> <td> <p>Specifies the comment for the PropertyMapping object.</p> </td> </tr> <tr> <td> <p><b>PropertyMapping.DataField</b></p> </td> <td> <p>The field of the data source which is mapped to the tile property.</p> </td> </tr> <tr> <td> <p><b>PropertyMapping.DataSource</b></p> </td> <td> <p>Specifies the gap between tile cells in a group.</p> </td> </tr> <tr> <td><strong>PropertyMapping.Lookup</strong></td> <td><span style='font-family: "Verdana","sans-serif"; font-size: 8pt; mso-bidi-font-family: "Angsana New"; mso-bidi-font-size: 10.0pt; mso-fareast-font-family: "Times New Roman"; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;'>Encapsulates the lookup properties.</span></td> </tr> <tr> <td><strong>PropertyMapping.TileControl</strong></td> <td><span style='font-family: "Verdana","sans-serif"; font-size: 8pt; mso-bidi-font-family: "Angsana New"; mso-bidi-font-size: 10.0pt; mso-fareast-font-family: "Times New Roman"; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;'>Gets the owner of the C1.Win.C1Tile.C1TileControl.</span></td> </tr> <tr> <td><strong>PropertyMapping.TileProperty</strong></td> <td><span style='font-family: "Verdana","sans-serif"; font-size: 8pt; mso-bidi-font-family: "Angsana New"; mso-bidi-font-size: 10.0pt; mso-fareast-font-family: "Times New Roman"; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;'>Gets or sets the property of the C1.Win.C1Tile.Tile object that is a destination for mapping.</span></td> </tr> </tbody> </table> <p>The <span class="LinkProperty"><a href="C1.Win.C1TileControl.4~C1.Win.C1Tile.PropertyMapping~TileProperty.html">PropertyMapping.TileProperty</a></span> can be set to any of the <span class="LinkEnumeration">TileProperty</span> enumeration values.</p> <p class="MsoBodyText"><span class="LinkClass">C1TileControl</span> uses the <span class="LinkClass"><a href="C1.Win.C1TileControl.4~C1.Win.C1Tile.MappingLookup.html">MappingLookup</a></span> class to display information from one table based on the value of a foreign-key field in another table.</p> <p class="MsoBodyText">For example, consider a table of <b style="mso-bidi-font-weight: normal;">Products</b> in a sales database. Each record in the <b style="mso-bidi-font-weight: normal;">Products</b> table includes a <b style="mso-bidi-font-weight: normal;">CategoryID</b> indicating which category the product belongs to. The <b style="mso-bidi-font-weight: normal;">CategoryID</b> is a foreign key pointing to a category record in the Categories table. When presenting a list of Products (from the Products table) you may want to display the actual categories name for each product, as opposed to the <b style="mso-bidi-font-weight: normal;">ProductsID</b>. Since the categories name is in the categories table, and you are presenting data from the Products table, you need to create a lookup table or <span class="LinkClass">MappingLookup</span> class which takes the <b style="mso-bidi-font-weight: normal;">CategoryID</b> value in the Products record, and uses that value to navigate the relationship and return the more readable, category name. This concept is known as a lookup table. For an example of creating a lookup table see <b style="mso-bidi-font-weight: normal;"><span style="mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">Adding Property Mappings to C1TileControl</span></b><span style="mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">.</span></p> <p class="MsoBodyText">The <span class="LinkClass"><a href="C1.Win.C1TileControl.4~C1.Win.C1Tile.MappingLookup.html">MappingLookup</a></span> class includes the following members:</p> <p class="MsoBodyText"> </p> <table> <tbody> <tr> <th>Property</th> <th>Description</th> </tr> <tr> <td> <p><b>MappingLookup.DataSource</b></p> </td> <td> <p>Gets or sets the data source object for the lookup.</p> </td> </tr> <tr> <td> <p><b>MappingLookup.DisplayMember</b></p> </td> <td> <p>The field of the data source which is mapped to the tile property.</p> </td> </tr> <tr> <td> <p><b>MappingLookup.ValueMember</b></p> </td> <td> <p>Gets or sets the field to use as the source of value (primary key) matching the foreign key in the C1.Win.C1Tile.PropertyMapping.DataField.</p> </td> </tr> </tbody> </table> <p>The <span class="LinkProperty"><a href="C1.Win.C1TileControl.4~C1.Win.C1Tile.PropertyMapping~TileProperty.html">PropertyMapping.TileProperty</a></span> can be set to any of the <span class="LinkEnumeration">TileProperty</span> enumeration values.</p> <p class="MsoBodyText"> </p> <a name="seealsobookmark"></a> </div> <div id="FooterContent"> <p> </p><p> </p><hr style="height: 1px"><p>Copyright (c) <script type="text/javascript"> var theDate=new Date() document.write(theDate.getFullYear()) </script> GrapeCity, inc. All rights reserved. <script> $(document).ready(function() { if (!(window.self !== window.top)) { // Not running in a frameset // Get the page name var pageName = location.href.substring(location.href.lastIndexOf("/") + 1); if (pageName.indexOf("#") != -1) { pageName = pageName.substring(0, pageName.indexOf("#")); } // Append to webframe.html var framePage = "webframe.html#" + pageName; location.href = framePage; } }); </script></p> <a target="_blank" href="http://our.componentone.com/groups/">Product Support Forum</a> | <a target="_blank" href="http://feedback.componentone.com/forums/255782-winforms-documentation">Documentation Feedback</a> </div> </body> </html>